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

package/src/lib/server/pos-hardware-returns.js

@@ -0,0 +1,502 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { formatOperatorAlertAmount } from "@aglyn/aglyn/app-utils/operator-alerts";
+import { firebaseAdmin, raiseOperatorAlert } from "@aglyn/tenant-data-admin";
+import * as CommerceModel from "../model/index.js";
+import { posOrderRefundRecord, POS_ORDER_REFUNDS_COLLECTION } from "../model/commerce-pos-day-report.js";
+import { POS_STRIPE_TENDERS } from "../model/commerce-pos-ops.js";
+import { formatPosHardwareCents, isPosHardwareSkuId, POS_HARDWARE_ORDER_ID, POS_HARDWARE_RETURN_REASON_MAX, posHardwareSaleRecord, posHardwareSaleSetOptions } from "../model/pos-hardware.js";
+import { COMMERCE_POS_HARDWARE_RETURN_REQUESTED } from "../constants/operator-alerts.js";
+import { hardwareOrdersRef, posHardwareOrderNumber, posHardwareSaleRef } from "./pos-hardware.js";
+import { posStripe } from "./pos-stripe.js";
+import { createStripeRefund } from "./stripe-refund.js";
+import { posOrderRefundHardwareId } from "./pos-order-refund-ids.js";
+/*==========================================
+ * RETURNING A CARD READER SOLD IN PERSON (AGL-4038).
+ *
+ * Three ways, and all of them pay back from the SELLING store's takings,
+ * the way the sale was paid — never from the platform's Checkout, which an
+ * in-person sale never used:
+ *
+ *   1. At the selling store's register, at a later event: the register's own
+ *      return (`pos-return.ts`) refunds the sale's tenders as for anything
+ *      else, and the hardware's share of it is written here onto the
+ *      hardware order and its retained sale record.
+ *   2. From the staff Hardware orders page: the card the sale was paid with
+ *      is refunded through the register sale's own Stripe refund (a
+ *      destination charge, so the money comes back out of the store's
+ *      connected account), recorded on the register sale as any refund is,
+ *      and on the hardware order. A sale paid in cash can only be refunded
+ *      at the register.
+ *   3. Requested by the buyer from their own purchase history: staff are
+ *      alerted, and refund it (2) or decline it.
+ *
+ * Each refund is written once by its key, and the order says Refunded once
+ * every hardware item on it has come back. Returns follow the hardware terms
+ * of sale; nothing here decides them.
+ *
+ * AN ORDER SHIPPED TO THE BUYER (AGL-4038) is asked back the same way (3)
+ * once it has shipped, and declined the same way. Staff refund it as a
+ * return ({@link refundReturnedOnlinePosHardwareOrder}): the items and their
+ * tax, less any restocking fee Stripe charged, on the platform's own
+ * account, since the platform's Checkout took the payment.
+ *=========================================*/ export class PosHardwareReturnRefusal extends Error {
+    constructor(message, status){
+        super(message), this.status = status;
+    }
+}
+function firestore() {
+    return firebaseAdmin.app().firestore();
+}
+const units = (order)=>{
+    var _order_lines;
+    return ((_order_lines = order.lines) != null ? _order_lines : []).reduce((sum, line)=>sum + (Number(line.quantity) || 0), 0);
+};
+/** The order with one more refund on it, or as it was when the key was already used. */ export function withPosHardwareRefund(order, refund) {
+    var _order_refunds, _order_totalCents, _ref, _refund_stripeRefundId;
+    const refunds = (_order_refunds = order.refunds) != null ? _order_refunds : [];
+    if (refunds.some((held)=>held.key === refund.key)) return order;
+    const next = [
+        ...refunds,
+        refund
+    ];
+    const refundedCents = next.reduce((sum, held)=>sum + held.cents, 0);
+    const returned = next.reduce((sum, held)=>sum + held.quantity, 0);
+    const whole = refundedCents >= ((_order_totalCents = order.totalCents) != null ? _order_totalCents : 0) || returned > 0 && returned >= units(order);
+    return _extends({}, order, {
+        refunds: next,
+        refundedCents,
+        refundedAtMs: refund.atMs,
+        refundId: (_ref = (_refund_stripeRefundId = refund.stripeRefundId) != null ? _refund_stripeRefundId : order.refundId) != null ? _ref : null
+    }, whole ? {
+        status: 'refunded'
+    } : {}, order.returnRequest && order.returnRequest.state === 'requested' ? {
+        returnRequest: _extends({}, order.returnRequest, {
+            state: 'refunded',
+            decidedAtMs: refund.atMs
+        })
+    } : {}, {
+        updatedAtMs: refund.atMs
+    });
+}
+/** Writes one refund onto a hardware order and its sale record, once. */ async function applyRefund(orderId, refund) {
+    const saleRef = posHardwareSaleRef(orderId);
+    return firestore().runTransaction(async (transaction)=>{
+        var _sale_get;
+        const sale = await transaction.get(saleRef);
+        if (!sale.exists) return null;
+        const ref = hardwareOrdersRef(String((_sale_get = sale.get('orgId')) != null ? _sale_get : '')).doc(orderId);
+        const snapshot = await transaction.get(ref);
+        if (!snapshot.exists) return null;
+        const before = snapshot.data();
+        const after = withPosHardwareRefund(before, refund);
+        if (after === before) return before;
+        transaction.set(ref, after);
+        transaction.set(saleRef, posHardwareSaleRecord(orderId, after), posHardwareSaleSetOptions(after));
+        return after;
+    });
+}
+/**
+ * A return at the selling store's register (way 1): the hardware's share of
+ * what the return refunded, by the lines it took back. Never throws into the
+ * return; the money has already gone back.
+ */ export async function recordRegisterHardwareReturn(input) {
+    const { config } = input;
+    if (!config || input.hostId !== config.sellerHostId || !input.lines.length) return null;
+    try {
+        var _register_get, _register_get1, _input_now;
+        const hostRef = firestore().collection('hosts').doc(input.hostId);
+        const register = await hostRef.collection('orders').doc(input.registerOrderId).get();
+        const orderId = String((_register_get = register.get('hardwareOrderId')) != null ? _register_get : '');
+        if (!POS_HARDWARE_ORDER_ID.test(orderId)) return null;
+        const lineItems = (_register_get1 = register.get('lineItems')) != null ? _register_get1 : [];
+        const productIds = [
+            ...new Set(input.lines.map((line)=>{
+                var _ref;
+                var _lineItems_line_index;
+                return String((_ref = (_lineItems_line_index = lineItems[line.index]) == null ? void 0 : _lineItems_line_index.productId) != null ? _ref : '');
+            }))
+        ].filter(Boolean);
+        const products = new Map((await Promise.all(productIds.map((id)=>hostRef.collection('products').doc(id).get()))).map((doc)=>[
+                String(doc.id),
+                doc.get('hardwareSku')
+            ]));
+        const hardware = input.lines.filter((line)=>{
+            var _ref;
+            var _lineItems_line_index;
+            return isPosHardwareSkuId(products.get(String((_ref = (_lineItems_line_index = lineItems[line.index]) == null ? void 0 : _lineItems_line_index.productId) != null ? _ref : '')));
+        });
+        if (!hardware.length) return null;
+        const linesCents = input.lines.reduce((sum, line)=>sum + Math.max(0, Math.round(line.refundCents)), 0);
+        const hardwareCents = hardware.reduce((sum, line)=>sum + Math.max(0, Math.round(line.refundCents)), 0);
+        // What actually went back, in the lines' own proportion: a card that
+        // refused after another tender paid back leaves a part-return.
+        const refunded = Math.max(0, Math.round(input.refundCents));
+        const cents = linesCents > 0 && refunded < linesCents ? Math.floor((refunded * hardwareCents * 2 + linesCents) / (linesCents * 2)) : hardwareCents;
+        return await applyRefund(orderId, {
+            key: `register:${input.returnId}`,
+            via: 'register',
+            cents,
+            quantity: hardware.reduce((sum, line)=>sum + Math.max(0, Math.round(line.quantity)), 0),
+            atMs: (_input_now = input.now) != null ? _input_now : Date.now(),
+            stripeRefundId: null
+        });
+    } catch (error) {
+        console.error('[pos-hardware-returns] a register return was not written to its hardware order', input.registerOrderId, error);
+        return null;
+    }
+}
+/**
+ * Refunds what is left of an in-person order from the staff page (way 2),
+ * through the register sale's own card refund. Refused for a sale paid by
+ * anything Stripe cannot refund, which goes back at the register instead.
+ */ export async function refundInPersonPosHardwareOrder(input) {
+    var _before_totalCents, _before_refundedCents, _ref, _ref1, _before_refunds, _input_now, _before_refunds1;
+    var _before_posSale, _before_posSale1, _sale_totals;
+    const { config } = input;
+    if (!config) throw new PosHardwareReturnRefusal('Card reader sales in person are off.', 409);
+    const ref = hardwareOrdersRef(input.orgId).doc(input.orderId);
+    const snapshot = await ref.get();
+    if (!snapshot.exists) throw new PosHardwareReturnRefusal('No such order', 404);
+    const before = snapshot.data();
+    if (before.source !== 'in_person' || ((_before_posSale = before.posSale) == null ? void 0 : _before_posSale.hostId) !== config.sellerHostId) {
+        throw new PosHardwareReturnRefusal('Only a card reader sold in person here is refunded this way.', 409);
+    }
+    if (before.status === 'refunded' || before.status === 'canceled') return {
+        before,
+        order: before
+    };
+    const cents = Math.max(0, ((_before_totalCents = before.totalCents) != null ? _before_totalCents : 0) - ((_before_refundedCents = before.refundedCents) != null ? _before_refundedCents : 0));
+    if (!cents) throw new PosHardwareReturnRefusal('Nothing is left to refund on this order.', 409);
+    const registerOrderId = String((_ref = (_before_posSale1 = before.posSale) == null ? void 0 : _before_posSale1.orderId) != null ? _ref : '');
+    const registerRef = firestore().collection('hosts').doc(config.sellerHostId).collection('orders').doc(registerOrderId);
+    const register = await registerRef.get();
+    if (!register.exists) throw new PosHardwareReturnRefusal('The register sale is missing.', 404);
+    const sale = register.data();
+    const card = CommerceModel.orderPayments(sale).filter((payment)=>payment.status === 'succeeded' && POS_STRIPE_TENDERS.has(payment.method) && payment.paymentIntentId).find((payment)=>payment.amountCents >= cents);
+    if (!(card == null ? void 0 : card.paymentIntentId)) {
+        throw new PosHardwareReturnRefusal('This card reader was not paid by one card that can take this refund. Refund it as a return at the selling store’s register instead.', 409);
+    }
+    const totalCents = Number((_ref1 = (_sale_totals = sale.totals) == null ? void 0 : _sale_totals.totalCents) != null ? _ref1 : 0);
+    // Reserve on the register sale first, as its own refunds do, so a refund
+    // there and one here cannot both take the same money.
+    const reserved = await firestore().runTransaction(async (transaction)=>{
+        var _data, _fresh_refundedCents;
+        const fresh = (_data = (await transaction.get(registerRef)).data()) != null ? _data : {};
+        const already = Number((_fresh_refundedCents = fresh['refundedCents']) != null ? _fresh_refundedCents : 0);
+        if (already + cents > totalCents) return false;
+        transaction.set(registerRef, {
+            refundedCents: already + cents
+        }, {
+            merge: true
+        });
+        return true;
+    });
+    if (!reserved) {
+        throw new PosHardwareReturnRefusal('The register sale was already refunded. Check it on the store’s orders.', 409);
+    }
+    const attempt = ((_before_refunds = before.refunds) != null ? _before_refunds : []).filter((held)=>held.via === 'staff').length + 1;
+    const refund = await createStripeRefund({
+        paymentIntentId: card.paymentIntentId,
+        amountCents: cents,
+        idempotencyKey: `pos-hw-refund-${input.orderId}-${attempt}`,
+        metadata: {
+            hostId: config.sellerHostId,
+            orderId: registerOrderId,
+            hardwareOrderId: input.orderId,
+            kind: 'pos-hardware-refund'
+        }
+    });
+    if ('error' in refund) {
+        // Stripe said no, so no money moved: the reservation goes back.
+        await firestore().runTransaction(async (transaction)=>{
+            var _get;
+            const current = Number((_get = (await transaction.get(registerRef)).get('refundedCents')) != null ? _get : 0);
+            transaction.set(registerRef, {
+                refundedCents: Math.max(0, current - cents)
+            }, {
+                merge: true
+            });
+        }).catch(()=>undefined);
+        throw new PosHardwareReturnRefusal(refund.error, refund.status === 409 ? 409 : 502);
+    }
+    const now = (_input_now = input.now) != null ? _input_now : Date.now();
+    const registerRefund = posOrderRefundRecord({
+        orderId: registerOrderId,
+        order: sale,
+        refundedCents: cents,
+        paymentIntentId: card.paymentIntentId,
+        cashierId: null,
+        source: 'staff',
+        stripeRefundId: refund.refundId || null,
+        atMs: now
+    });
+    await firestore().runTransaction(async (transaction)=>{
+        var _data, _fresh_refundedCents;
+        const fresh = (_data = (await transaction.get(registerRef)).data()) != null ? _data : {};
+        const refundedCents = Number((_fresh_refundedCents = fresh['refundedCents']) != null ? _fresh_refundedCents : 0);
+        transaction.set(registerRef, _extends({}, refundedCents >= totalCents ? {
+            status: 'refunded'
+        } : {}, {
+            updatedAtMs: now,
+            timeline: firebaseAdmin.firestore.FieldValue.arrayUnion({
+                atMs: now,
+                event: 'refund',
+                detail: `Card reader refunded from the staff hardware page: ${formatPosHardwareCents(cents)}`
+            })
+        }), {
+            merge: true
+        });
+        if (registerRefund) {
+            transaction.set(firestore().collection('hosts').doc(config.sellerHostId).collection('registers').doc(registerRefund.registerId).collection(POS_ORDER_REFUNDS_COLLECTION).doc(refund.refundId || posOrderRefundHardwareId(registerOrderId, attempt)), registerRefund);
+        }
+    });
+    const order = await applyRefund(input.orderId, {
+        key: `staff:${attempt}`,
+        via: 'staff',
+        cents,
+        quantity: Math.max(0, units(before) - ((_before_refunds1 = before.refunds) != null ? _before_refunds1 : []).reduce((sum, held)=>sum + held.quantity, 0)),
+        atMs: now,
+        stripeRefundId: refund.refundId || null
+    });
+    return {
+        before,
+        order: order != null ? order : before
+    };
+}
+/**
+ * The statuses an online order may be asked back in (AGL-4038): once it has
+ * shipped. Before that, changing or canceling it is for support, who cancel
+ * and refund it in full from the staff page.
+ */ export const POS_HARDWARE_ONLINE_RETURNABLE = [
+    'shipped',
+    'delivered',
+    'registered'
+];
+/**
+ * The buyer asks to return an order (way 3), from their own purchase
+ * history: once while a request is open, with a reason. Staff are alerted.
+ * An in-person order any time before it is refunded; an online one once it
+ * has shipped (AGL-4038), which staff refund as a return
+ * ({@link refundReturnedOnlinePosHardwareOrder}) or decline. Never for an
+ * order already refunded.
+ */ export async function requestPosHardwareReturn(input) {
+    var _input_reason, _input_now;
+    const reason = String((_input_reason = input.reason) != null ? _input_reason : '').trim().slice(0, POS_HARDWARE_RETURN_REASON_MAX);
+    if (reason.length < 3) throw new PosHardwareReturnRefusal('Say why you are returning it.', 400);
+    if (!POS_HARDWARE_ORDER_ID.test(input.orderId)) throw new PosHardwareReturnRefusal('No such order.', 404);
+    const ref = hardwareOrdersRef(input.orgId).doc(input.orderId);
+    const now = (_input_now = input.now) != null ? _input_now : Date.now();
+    const outcome = await firestore().runTransaction(async (transaction)=>{
+        var _before_returnRequest;
+        const snapshot = await transaction.get(ref);
+        if (!snapshot.exists) throw new PosHardwareReturnRefusal('No such order.', 404);
+        const before = snapshot.data();
+        if (before.status === 'refunded' || before.status === 'canceled') {
+            throw new PosHardwareReturnRefusal('This order was already refunded.', 409);
+        }
+        if (before.source !== 'in_person' && !POS_HARDWARE_ONLINE_RETURNABLE.includes(before.status)) {
+            throw new PosHardwareReturnRefusal('This order has not shipped yet. To change or cancel it, contact support.', 409);
+        }
+        if (((_before_returnRequest = before.returnRequest) == null ? void 0 : _before_returnRequest.state) === 'requested') return {
+            order: before,
+            created: false
+        };
+        const after = _extends({}, before, {
+            returnRequest: {
+                state: 'requested',
+                reason,
+                requestedBy: input.uid,
+                requestedAtMs: now,
+                decidedBy: null,
+                decidedAtMs: null,
+                note: null
+            },
+            updatedAtMs: now
+        });
+        transaction.set(ref, after);
+        return {
+            order: after,
+            created: true
+        };
+    });
+    if (outcome.created) {
+        try {
+            var _outcome_order_totalCents, _outcome_order_lines;
+            var _outcome_order_posSale;
+            await raiseOperatorAlert(COMMERCE_POS_HARDWARE_RETURN_REQUESTED, {
+                dedupeKey: `${input.orderId}:${now}`,
+                orgId: input.orgId,
+                hostId: outcome.order.hostId || ((_outcome_order_posSale = outcome.order.posSale) == null ? void 0 : _outcome_order_posSale.hostId) || '',
+                context: {
+                    orderNumber: posHardwareOrderNumber(input.orderId),
+                    amount: formatOperatorAlertAmount((_outcome_order_totalCents = outcome.order.totalCents) != null ? _outcome_order_totalCents : 0),
+                    orgId: input.orgId,
+                    items: ((_outcome_order_lines = outcome.order.lines) != null ? _outcome_order_lines : []).map((line)=>`${line.quantity} × ${line.name}`).join(', '),
+                    reason
+                }
+            });
+        } catch (error) {
+            console.error('[pos-hardware-returns] return request alert failed', input.orderId, error);
+        }
+    }
+    return outcome.order;
+}
+/** Staff decline an open return request, with a note for the buyer. */ export async function declinePosHardwareReturn(input) {
+    var _input_note, _input_now;
+    const note = String((_input_note = input.note) != null ? _input_note : '').trim().slice(0, POS_HARDWARE_RETURN_REASON_MAX) || null;
+    const ref = hardwareOrdersRef(input.orgId).doc(input.orderId);
+    const now = (_input_now = input.now) != null ? _input_now : Date.now();
+    return firestore().runTransaction(async (transaction)=>{
+        var _before_returnRequest;
+        const snapshot = await transaction.get(ref);
+        if (!snapshot.exists) throw new PosHardwareReturnRefusal('No such order', 404);
+        const before = snapshot.data();
+        if (((_before_returnRequest = before.returnRequest) == null ? void 0 : _before_returnRequest.state) !== 'requested') {
+            throw new PosHardwareReturnRefusal('There is no open return request on this order.', 409);
+        }
+        const order = _extends({}, before, {
+            returnRequest: _extends({}, before.returnRequest, {
+                state: 'declined',
+                decidedBy: input.actorUid,
+                decidedAtMs: now,
+                note
+            }),
+            updatedAtMs: now
+        });
+        transaction.set(ref, order);
+        return {
+            before,
+            order
+        };
+    });
+}
+/** The idempotency key of an online return's refund: the order and the amount. */ export function posHardwareReturnRefundKey(orderId, cents) {
+    return `pos-hw-return-${orderId}-${cents}`;
+}
+/** What an online return gives back: the items and their tax, never the original shipping. */ export function posHardwareReturnRefundableCents(order) {
+    var _order_totalCents, _ref;
+    var _order_shipping;
+    return Math.max(0, ((_order_totalCents = order.totalCents) != null ? _order_totalCents : 0) - ((_ref = (_order_shipping = order.shipping) == null ? void 0 : _order_shipping.cents) != null ? _ref : 0));
+}
+/**
+ * Staff refund an ONLINE order the buyer sent back (AGL-4038), from the
+ * staff Hardware orders page, once its return was requested: the price of
+ * the items and the tax on them, less any restocking fee Stripe charged for
+ * the return, to the card it was paid with on the platform's own account.
+ * The original shipping is not refunded, under the hardware terms of sale.
+ *
+ * Claimed first, as a cancel is (`refundRequestedAtMs`), so two presses make
+ * one refund; the Stripe key names the order and the amount, so a retry of
+ * the same refund is the same refund. The order says Refunded, its return
+ * request Refunded, and the refund is written once by its key, with the
+ * sale record in the same transaction.
+ */ export async function refundReturnedOnlinePosHardwareOrder(input) {
+    var _input_now;
+    var _asked_body;
+    const fee = input.restockingFeeCents === undefined || input.restockingFeeCents === null || input.restockingFeeCents === '' ? 0 : Number(input.restockingFeeCents);
+    if (!Number.isSafeInteger(fee) || fee < 0) {
+        throw new PosHardwareReturnRefusal('Enter the restocking fee in whole cents, or 0.', 400);
+    }
+    if (!POS_HARDWARE_ORDER_ID.test(input.orderId)) throw new PosHardwareReturnRefusal('No such order', 404);
+    const now = (_input_now = input.now) != null ? _input_now : Date.now;
+    const ref = hardwareOrdersRef(input.orgId).doc(input.orderId);
+    const claimed = await firestore().runTransaction(async (transaction)=>{
+        var _before_returnRequest;
+        const snapshot = await transaction.get(ref);
+        if (!snapshot.exists) throw new PosHardwareReturnRefusal('No such order', 404);
+        const before = snapshot.data();
+        if (before.source === 'in_person') {
+            throw new PosHardwareReturnRefusal('A reader sold in person is refunded with Refund.', 409);
+        }
+        if (((_before_returnRequest = before.returnRequest) == null ? void 0 : _before_returnRequest.state) !== 'requested') {
+            throw new PosHardwareReturnRefusal('There is no open return request on this order.', 409);
+        }
+        if (!POS_HARDWARE_ONLINE_RETURNABLE.includes(before.status)) {
+            throw new PosHardwareReturnRefusal('Only an order that has shipped is refunded as a return.', 409);
+        }
+        if (!before.stripePaymentIntentId) throw new PosHardwareReturnRefusal('This order has no payment to refund.', 409);
+        if (before.refundRequestedAtMs && now() - before.refundRequestedAtMs < 2 * 60 * 1000) {
+            throw new PosHardwareReturnRefusal('A refund of this order is already in progress.', 409);
+        }
+        const cents = posHardwareReturnRefundableCents(before) - fee;
+        if (cents <= 0) throw new PosHardwareReturnRefusal('The restocking fee leaves nothing to refund.', 400);
+        transaction.update(ref, {
+            refundRequestedAtMs: now()
+        });
+        return {
+            before: before,
+            cents
+        };
+    });
+    const { before, cents } = claimed;
+    const asked = await posStripe('POST', 'refunds', {
+        params: {
+            payment_intent: before.stripePaymentIntentId,
+            amount: cents,
+            'metadata[type]': 'pos-hardware-return',
+            'metadata[orderId]': input.orderId,
+            'metadata[orgId]': input.orgId
+        },
+        idempotencyKey: posHardwareReturnRefundKey(input.orderId, cents)
+    });
+    if (!asked.ok || !((_asked_body = asked.body) == null ? void 0 : _asked_body.id)) {
+        var _ref;
+        var _asked_body_error, _asked_body1;
+        await ref.update({
+            refundRequestedAtMs: firebaseAdmin.firestore.FieldValue.delete()
+        }).catch(()=>undefined);
+        throw new PosHardwareReturnRefusal(String((_ref = (_asked_body1 = asked.body) == null ? void 0 : (_asked_body_error = _asked_body1.error) == null ? void 0 : _asked_body_error.message) != null ? _ref : '') || 'Stripe refused the refund.', asked.status === 400 ? 409 : 502);
+    }
+    const at = now();
+    const stripeRefundId = String(asked.body.id);
+    const saleRef = posHardwareSaleRef(input.orderId);
+    const order = await firestore().runTransaction(async (transaction)=>{
+        const snapshot = await transaction.get(ref);
+        const current = snapshot.data();
+        const settled = _extends({}, current);
+        delete settled.refundRequestedAtMs;
+        const refunded = withPosHardwareRefund(settled, {
+            key: `return:${stripeRefundId}`,
+            via: 'staff',
+            cents,
+            quantity: units(settled),
+            atMs: at,
+            stripeRefundId
+        });
+        const after = _extends({}, refunded, {
+            // Every item came back: the order is Refunded, whatever was kept.
+            status: 'refunded',
+            refundedAtMs: at,
+            returnRequest: refunded.returnRequest ? _extends({}, refunded.returnRequest, {
+                state: 'refunded',
+                decidedBy: input.actorUid,
+                decidedAtMs: at
+            }) : refunded.returnRequest
+        });
+        transaction.set(ref, after);
+        transaction.set(saleRef, posHardwareSaleRecord(input.orderId, after), posHardwareSaleSetOptions(after));
+        return after;
+    });
+    return {
+        before,
+        order,
+        cents
+    };
+}
+
+//# sourceMappingURL=pos-hardware-returns.js.map

package/src/lib/server/pos-hardware-returns.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/server/pos-hardware-returns.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { formatOperatorAlertAmount } from '@aglyn/aglyn/app-utils/operator-alerts'\nimport { firebaseAdmin, raiseOperatorAlert } from '@aglyn/tenant-data-admin'\nimport * as CommerceModel from '../model'\nimport { posOrderRefundRecord, POS_ORDER_REFUNDS_COLLECTION } from '../model/commerce-pos-day-report'\nimport { POS_STRIPE_TENDERS, type PosTenderSource } from '../model/commerce-pos-ops'\nimport {\n  formatPosHardwareCents,\n  isPosHardwareSkuId,\n  POS_HARDWARE_ORDER_ID,\n  POS_HARDWARE_RETURN_REASON_MAX,\n  posHardwareSaleRecord,\n  posHardwareSaleSetOptions,\n  type PosHardwareInPersonConfig,\n  type PosHardwareOrder,\n  type PosHardwareRefund,\n} from '../model/pos-hardware'\nimport { COMMERCE_POS_HARDWARE_RETURN_REQUESTED } from '../constants/operator-alerts'\nimport { hardwareOrdersRef, posHardwareOrderNumber, posHardwareSaleRef } from './pos-hardware'\nimport { posStripe } from './pos-stripe'\nimport { createStripeRefund } from './stripe-refund'\nimport { posOrderRefundHardwareId } from './pos-order-refund-ids'\n\n/*==========================================\n * RETURNING A CARD READER SOLD IN PERSON (AGL-4038).\n *\n * Three ways, and all of them pay back from the SELLING store's takings,\n * the way the sale was paid — never from the platform's Checkout, which an\n * in-person sale never used:\n *\n *   1. At the selling store's register, at a later event: the register's own\n *      return (`pos-return.ts`) refunds the sale's tenders as for anything\n *      else, and the hardware's share of it is written here onto the\n *      hardware order and its retained sale record.\n *   2. From the staff Hardware orders page: the card the sale was paid with\n *      is refunded through the register sale's own Stripe refund (a\n *      destination charge, so the money comes back out of the store's\n *      connected account), recorded on the register sale as any refund is,\n *      and on the hardware order. A sale paid in cash can only be refunded\n *      at the register.\n *   3. Requested by the buyer from their own purchase history: staff are\n *      alerted, and refund it (2) or decline it.\n *\n * Each refund is written once by its key, and the order says Refunded once\n * every hardware item on it has come back. Returns follow the hardware terms\n * of sale; nothing here decides them.\n *\n * AN ORDER SHIPPED TO THE BUYER (AGL-4038) is asked back the same way (3)\n * once it has shipped, and declined the same way. Staff refund it as a\n * return ({@link refundReturnedOnlinePosHardwareOrder}): the items and their\n * tax, less any restocking fee Stripe charged, on the platform's own\n * account, since the platform's Checkout took the payment.\n *=========================================*/\n\nexport class PosHardwareReturnRefusal extends Error {\n  constructor(\n    message: string,\n    readonly status: number,\n  ) {\n    super(message)\n  }\n}\n\nfunction firestore() {\n  return firebaseAdmin.app().firestore()\n}\n\nconst units = (order: Pick<PosHardwareOrder, 'lines'>) =>\n  (order.lines ?? []).reduce((sum, line) => sum + (Number(line.quantity) || 0), 0)\n\n/** The order with one more refund on it, or as it was when the key was already used. */\nexport function withPosHardwareRefund(order: PosHardwareOrder, refund: PosHardwareRefund): PosHardwareOrder {\n  const refunds = order.refunds ?? []\n  if (refunds.some((held) => held.key === refund.key)) return order\n  const next = [...refunds, refund]\n  const refundedCents = next.reduce((sum, held) => sum + held.cents, 0)\n  const returned = next.reduce((sum, held) => sum + held.quantity, 0)\n  const whole = refundedCents >= (order.totalCents ?? 0) || (returned > 0 && returned >= units(order))\n  return {\n    ...order,\n    refunds: next,\n    refundedCents,\n    refundedAtMs: refund.atMs,\n    refundId: refund.stripeRefundId ?? order.refundId ?? null,\n    ...(whole ? { status: 'refunded' as const } : {}),\n    ...(order.returnRequest && order.returnRequest.state === 'requested'\n      ? { returnRequest: { ...order.returnRequest, state: 'refunded' as const, decidedAtMs: refund.atMs } }\n      : {}),\n    updatedAtMs: refund.atMs,\n  }\n}\n\n/** Writes one refund onto a hardware order and its sale record, once. */\nasync function applyRefund(orderId: string, refund: PosHardwareRefund): Promise<PosHardwareOrder | null> {\n  const saleRef = posHardwareSaleRef(orderId)\n  return firestore().runTransaction(async (transaction: any) => {\n    const sale = await transaction.get(saleRef)\n    if (!sale.exists) return null\n    const ref = hardwareOrdersRef(String(sale.get('orgId') ?? '')).doc(orderId)\n    const snapshot = await transaction.get(ref)\n    if (!snapshot.exists) return null\n    const before = snapshot.data() as PosHardwareOrder\n    const after = withPosHardwareRefund(before, refund)\n    if (after === before) return before\n    transaction.set(ref, after)\n    transaction.set(saleRef, posHardwareSaleRecord(orderId, after), posHardwareSaleSetOptions(after))\n    return after\n  })\n}\n\n/**\n * A return at the selling store's register (way 1): the hardware's share of\n * what the return refunded, by the lines it took back. Never throws into the\n * return; the money has already gone back.\n */\nexport async function recordRegisterHardwareReturn(input: {\n  config: PosHardwareInPersonConfig | null\n  hostId: string\n  registerOrderId: string\n  returnId: string\n  refundCents: number\n  lines: ReadonlyArray<{ index: number; quantity: number; refundCents: number }>\n  now?: number\n}): Promise<PosHardwareOrder | null> {\n  const { config } = input\n  if (!config || input.hostId !== config.sellerHostId || !input.lines.length) return null\n  try {\n    const hostRef = firestore().collection('hosts').doc(input.hostId)\n    const register = await hostRef.collection('orders').doc(input.registerOrderId).get()\n    const orderId = String(register.get('hardwareOrderId') ?? '')\n    if (!POS_HARDWARE_ORDER_ID.test(orderId)) return null\n    const lineItems = (register.get('lineItems') ?? []) as CommerceModel.OrderLineItem[]\n    const productIds = [...new Set(input.lines.map((line) => String(lineItems[line.index]?.productId ?? '')))].filter(Boolean)\n    const products = new Map(\n      (await Promise.all(productIds.map((id) => hostRef.collection('products').doc(id).get()))).map((doc: any) => [\n        String(doc.id),\n        doc.get('hardwareSku'),\n      ]),\n    )\n    const hardware = input.lines.filter((line) =>\n      isPosHardwareSkuId(products.get(String(lineItems[line.index]?.productId ?? ''))),\n    )\n    if (!hardware.length) return null\n    const linesCents = input.lines.reduce((sum, line) => sum + Math.max(0, Math.round(line.refundCents)), 0)\n    const hardwareCents = hardware.reduce((sum, line) => sum + Math.max(0, Math.round(line.refundCents)), 0)\n    // What actually went back, in the lines' own proportion: a card that\n    // refused after another tender paid back leaves a part-return.\n    const refunded = Math.max(0, Math.round(input.refundCents))\n    const cents =\n      linesCents > 0 && refunded < linesCents\n        ? Math.floor((refunded * hardwareCents * 2 + linesCents) / (linesCents * 2))\n        : hardwareCents\n    return await applyRefund(orderId, {\n      key: `register:${input.returnId}`,\n      via: 'register',\n      cents,\n      quantity: hardware.reduce((sum, line) => sum + Math.max(0, Math.round(line.quantity)), 0),\n      atMs: input.now ?? Date.now(),\n      stripeRefundId: null,\n    })\n  } catch (error) {\n    console.error('[pos-hardware-returns] a register return was not written to its hardware order', input.registerOrderId, error)\n    return null\n  }\n}\n\n/**\n * Refunds what is left of an in-person order from the staff page (way 2),\n * through the register sale's own card refund. Refused for a sale paid by\n * anything Stripe cannot refund, which goes back at the register instead.\n */\nexport async function refundInPersonPosHardwareOrder(input: {\n  config: PosHardwareInPersonConfig | null\n  orgId: string\n  orderId: string\n  actorUid: string\n  now?: number\n}): Promise<{ before: PosHardwareOrder; order: PosHardwareOrder }> {\n  const { config } = input\n  if (!config) throw new PosHardwareReturnRefusal('Card reader sales in person are off.', 409)\n  const ref = hardwareOrdersRef(input.orgId).doc(input.orderId)\n  const snapshot = await ref.get()\n  if (!snapshot.exists) throw new PosHardwareReturnRefusal('No such order', 404)\n  const before = snapshot.data() as PosHardwareOrder\n  if (before.source !== 'in_person' || before.posSale?.hostId !== config.sellerHostId) {\n    throw new PosHardwareReturnRefusal('Only a card reader sold in person here is refunded this way.', 409)\n  }\n  if (before.status === 'refunded' || before.status === 'canceled') return { before, order: before }\n  const cents = Math.max(0, (before.totalCents ?? 0) - (before.refundedCents ?? 0))\n  if (!cents) throw new PosHardwareReturnRefusal('Nothing is left to refund on this order.', 409)\n  const registerOrderId = String(before.posSale?.orderId ?? '')\n  const registerRef = firestore().collection('hosts').doc(config.sellerHostId).collection('orders').doc(registerOrderId)\n  const register = await registerRef.get()\n  if (!register.exists) throw new PosHardwareReturnRefusal('The register sale is missing.', 404)\n  const sale = register.data() as PosTenderSource & CommerceModel.HostOrder & { refundedCents?: number }\n  const card = CommerceModel.orderPayments(sale as never)\n    .filter((payment) => payment.status === 'succeeded' && POS_STRIPE_TENDERS.has(payment.method) && payment.paymentIntentId)\n    .find((payment) => payment.amountCents >= cents)\n  if (!card?.paymentIntentId) {\n    throw new PosHardwareReturnRefusal(\n      'This card reader was not paid by one card that can take this refund. Refund it as a return at the selling store’s register instead.',\n      409,\n    )\n  }\n  const totalCents = Number(sale.totals?.totalCents ?? 0)\n  // Reserve on the register sale first, as its own refunds do, so a refund\n  // there and one here cannot both take the same money.\n  const reserved = await firestore().runTransaction(async (transaction: any) => {\n    const fresh = (await transaction.get(registerRef)).data() ?? {}\n    const already = Number(fresh['refundedCents'] ?? 0)\n    if (already + cents > totalCents) return false\n    transaction.set(registerRef, { refundedCents: already + cents }, { merge: true })\n    return true\n  })\n  if (!reserved) {\n    throw new PosHardwareReturnRefusal('The register sale was already refunded. Check it on the store’s orders.', 409)\n  }\n  const attempt = (before.refunds ?? []).filter((held) => held.via === 'staff').length + 1\n  const refund = await createStripeRefund({\n    paymentIntentId: card.paymentIntentId,\n    amountCents: cents,\n    idempotencyKey: `pos-hw-refund-${input.orderId}-${attempt}`,\n    metadata: {\n      hostId: config.sellerHostId,\n      orderId: registerOrderId,\n      hardwareOrderId: input.orderId,\n      kind: 'pos-hardware-refund',\n    },\n  })\n  if ('error' in refund) {\n    // Stripe said no, so no money moved: the reservation goes back.\n    await firestore()\n      .runTransaction(async (transaction: any) => {\n        const current = Number((await transaction.get(registerRef)).get('refundedCents') ?? 0)\n        transaction.set(registerRef, { refundedCents: Math.max(0, current - cents) }, { merge: true })\n      })\n      .catch(() => undefined)\n    throw new PosHardwareReturnRefusal(refund.error, refund.status === 409 ? 409 : 502)\n  }\n  const now = input.now ?? Date.now()\n  const registerRefund = posOrderRefundRecord({\n    orderId: registerOrderId,\n    order: sale as PosTenderSource & { registerId?: unknown },\n    refundedCents: cents,\n    paymentIntentId: card.paymentIntentId,\n    cashierId: null,\n    source: 'staff',\n    stripeRefundId: refund.refundId || null,\n    atMs: now,\n  })\n  await firestore().runTransaction(async (transaction: any) => {\n    const fresh = (await transaction.get(registerRef)).data() ?? {}\n    const refundedCents = Number(fresh['refundedCents'] ?? 0)\n    transaction.set(\n      registerRef,\n      {\n        ...(refundedCents >= totalCents ? { status: 'refunded' } : {}),\n        updatedAtMs: now,\n        timeline: firebaseAdmin.firestore.FieldValue.arrayUnion({\n          atMs: now,\n          event: 'refund',\n          detail: `Card reader refunded from the staff hardware page: ${formatPosHardwareCents(cents)}`,\n        }),\n      },\n      { merge: true },\n    )\n    if (registerRefund) {\n      transaction.set(\n        firestore()\n          .collection('hosts')\n          .doc(config.sellerHostId)\n          .collection('registers')\n          .doc(registerRefund.registerId)\n          .collection(POS_ORDER_REFUNDS_COLLECTION)\n          .doc(refund.refundId || posOrderRefundHardwareId(registerOrderId, attempt)),\n        registerRefund,\n      )\n    }\n  })\n  const order = await applyRefund(input.orderId, {\n    key: `staff:${attempt}`,\n    via: 'staff',\n    cents,\n    quantity: Math.max(0, units(before) - (before.refunds ?? []).reduce((sum, held) => sum + held.quantity, 0)),\n    atMs: now,\n    stripeRefundId: refund.refundId || null,\n  })\n  return { before, order: order ?? before }\n}\n\n/**\n * The statuses an online order may be asked back in (AGL-4038): once it has\n * shipped. Before that, changing or canceling it is for support, who cancel\n * and refund it in full from the staff page.\n */\nexport const POS_HARDWARE_ONLINE_RETURNABLE: readonly PosHardwareOrder['status'][] = ['shipped', 'delivered', 'registered']\n\n/**\n * The buyer asks to return an order (way 3), from their own purchase\n * history: once while a request is open, with a reason. Staff are alerted.\n * An in-person order any time before it is refunded; an online one once it\n * has shipped (AGL-4038), which staff refund as a return\n * ({@link refundReturnedOnlinePosHardwareOrder}) or decline. Never for an\n * order already refunded.\n */\nexport async function requestPosHardwareReturn(input: {\n  orgId: string\n  orderId: string\n  uid: string\n  reason: unknown\n  now?: number\n}): Promise<PosHardwareOrder> {\n  const reason = String(input.reason ?? '').trim().slice(0, POS_HARDWARE_RETURN_REASON_MAX)\n  if (reason.length < 3) throw new PosHardwareReturnRefusal('Say why you are returning it.', 400)\n  if (!POS_HARDWARE_ORDER_ID.test(input.orderId)) throw new PosHardwareReturnRefusal('No such order.', 404)\n  const ref = hardwareOrdersRef(input.orgId).doc(input.orderId)\n  const now = input.now ?? Date.now()\n  const outcome = await firestore().runTransaction(async (transaction: any) => {\n    const snapshot = await transaction.get(ref)\n    if (!snapshot.exists) throw new PosHardwareReturnRefusal('No such order.', 404)\n    const before = snapshot.data() as PosHardwareOrder\n    if (before.status === 'refunded' || before.status === 'canceled') {\n      throw new PosHardwareReturnRefusal('This order was already refunded.', 409)\n    }\n    if (before.source !== 'in_person' && !POS_HARDWARE_ONLINE_RETURNABLE.includes(before.status)) {\n      throw new PosHardwareReturnRefusal(\n        'This order has not shipped yet. To change or cancel it, contact support.',\n        409,\n      )\n    }\n    if (before.returnRequest?.state === 'requested') return { order: before, created: false }\n    const after: PosHardwareOrder = {\n      ...before,\n      returnRequest: {\n        state: 'requested',\n        reason,\n        requestedBy: input.uid,\n        requestedAtMs: now,\n        decidedBy: null,\n        decidedAtMs: null,\n        note: null,\n      },\n      updatedAtMs: now,\n    }\n    transaction.set(ref, after)\n    return { order: after, created: true }\n  })\n  if (outcome.created) {\n    try {\n      await raiseOperatorAlert(COMMERCE_POS_HARDWARE_RETURN_REQUESTED, {\n        dedupeKey: `${input.orderId}:${now}`,\n        orgId: input.orgId,\n        hostId: outcome.order.hostId || outcome.order.posSale?.hostId || '',\n        context: {\n          orderNumber: posHardwareOrderNumber(input.orderId),\n          amount: formatOperatorAlertAmount(outcome.order.totalCents ?? 0),\n          orgId: input.orgId,\n          items: (outcome.order.lines ?? []).map((line) => `${line.quantity} × ${line.name}`).join(', '),\n          reason,\n        },\n      })\n    } catch (error) {\n      console.error('[pos-hardware-returns] return request alert failed', input.orderId, error)\n    }\n  }\n  return outcome.order\n}\n\n/** Staff decline an open return request, with a note for the buyer. */\nexport async function declinePosHardwareReturn(input: {\n  orgId: string\n  orderId: string\n  actorUid: string\n  note: unknown\n  now?: number\n}): Promise<{ before: PosHardwareOrder; order: PosHardwareOrder }> {\n  const note = String(input.note ?? '').trim().slice(0, POS_HARDWARE_RETURN_REASON_MAX) || null\n  const ref = hardwareOrdersRef(input.orgId).doc(input.orderId)\n  const now = input.now ?? Date.now()\n  return firestore().runTransaction(async (transaction: any) => {\n    const snapshot = await transaction.get(ref)\n    if (!snapshot.exists) throw new PosHardwareReturnRefusal('No such order', 404)\n    const before = snapshot.data() as PosHardwareOrder\n    if (before.returnRequest?.state !== 'requested') {\n      throw new PosHardwareReturnRefusal('There is no open return request on this order.', 409)\n    }\n    const order: PosHardwareOrder = {\n      ...before,\n      returnRequest: { ...before.returnRequest, state: 'declined', decidedBy: input.actorUid, decidedAtMs: now, note },\n      updatedAtMs: now,\n    }\n    transaction.set(ref, order)\n    return { before, order }\n  })\n}\n\n/** The idempotency key of an online return's refund: the order and the amount. */\nexport function posHardwareReturnRefundKey(orderId: string, cents: number): string {\n  return `pos-hw-return-${orderId}-${cents}`\n}\n\n/** What an online return gives back: the items and their tax, never the original shipping. */\nexport function posHardwareReturnRefundableCents(order: Pick<PosHardwareOrder, 'totalCents' | 'shipping'>): number {\n  return Math.max(0, (order.totalCents ?? 0) - (order.shipping?.cents ?? 0))\n}\n\n/**\n * Staff refund an ONLINE order the buyer sent back (AGL-4038), from the\n * staff Hardware orders page, once its return was requested: the price of\n * the items and the tax on them, less any restocking fee Stripe charged for\n * the return, to the card it was paid with on the platform's own account.\n * The original shipping is not refunded, under the hardware terms of sale.\n *\n * Claimed first, as a cancel is (`refundRequestedAtMs`), so two presses make\n * one refund; the Stripe key names the order and the amount, so a retry of\n * the same refund is the same refund. The order says Refunded, its return\n * request Refunded, and the refund is written once by its key, with the\n * sale record in the same transaction.\n */\nexport async function refundReturnedOnlinePosHardwareOrder(input: {\n  orgId: string\n  orderId: string\n  actorUid: string\n  restockingFeeCents: unknown\n  now?: () => number\n}): Promise<{ before: PosHardwareOrder; order: PosHardwareOrder; cents: number }> {\n  const fee = input.restockingFeeCents === undefined || input.restockingFeeCents === null || input.restockingFeeCents === '' ? 0 : Number(input.restockingFeeCents)\n  if (!Number.isSafeInteger(fee) || fee < 0) {\n    throw new PosHardwareReturnRefusal('Enter the restocking fee in whole cents, or 0.', 400)\n  }\n  if (!POS_HARDWARE_ORDER_ID.test(input.orderId)) throw new PosHardwareReturnRefusal('No such order', 404)\n  const now = input.now ?? Date.now\n  const ref = hardwareOrdersRef(input.orgId).doc(input.orderId)\n  const claimed = await firestore().runTransaction(async (transaction: any) => {\n    const snapshot = await transaction.get(ref)\n    if (!snapshot.exists) throw new PosHardwareReturnRefusal('No such order', 404)\n    const before = snapshot.data() as PosHardwareOrder & { refundRequestedAtMs?: number }\n    if (before.source === 'in_person') {\n      throw new PosHardwareReturnRefusal('A reader sold in person is refunded with Refund.', 409)\n    }\n    if (before.returnRequest?.state !== 'requested') {\n      throw new PosHardwareReturnRefusal('There is no open return request on this order.', 409)\n    }\n    if (!POS_HARDWARE_ONLINE_RETURNABLE.includes(before.status)) {\n      throw new PosHardwareReturnRefusal('Only an order that has shipped is refunded as a return.', 409)\n    }\n    if (!before.stripePaymentIntentId) throw new PosHardwareReturnRefusal('This order has no payment to refund.', 409)\n    if (before.refundRequestedAtMs && now() - before.refundRequestedAtMs < 2 * 60 * 1000) {\n      throw new PosHardwareReturnRefusal('A refund of this order is already in progress.', 409)\n    }\n    const cents = posHardwareReturnRefundableCents(before) - fee\n    if (cents <= 0) throw new PosHardwareReturnRefusal('The restocking fee leaves nothing to refund.', 400)\n    transaction.update(ref, { refundRequestedAtMs: now() })\n    return { before: before as PosHardwareOrder, cents }\n  })\n  const { before, cents } = claimed\n  const asked = await posStripe('POST', 'refunds', {\n    params: {\n      payment_intent: before.stripePaymentIntentId,\n      amount: cents,\n      'metadata[type]': 'pos-hardware-return',\n      'metadata[orderId]': input.orderId,\n      'metadata[orgId]': input.orgId,\n    },\n    idempotencyKey: posHardwareReturnRefundKey(input.orderId, cents),\n  })\n  if (!asked.ok || !asked.body?.id) {\n    await ref.update({ refundRequestedAtMs: firebaseAdmin.firestore.FieldValue.delete() }).catch(() => undefined)\n    throw new PosHardwareReturnRefusal(\n      String(asked.body?.error?.message ?? '') || 'Stripe refused the refund.',\n      asked.status === 400 ? 409 : 502,\n    )\n  }\n  const at = now()\n  const stripeRefundId = String(asked.body.id)\n  const saleRef = posHardwareSaleRef(input.orderId)\n  const order = await firestore().runTransaction(async (transaction: any) => {\n    const snapshot = await transaction.get(ref)\n    const current = snapshot.data() as PosHardwareOrder & { refundRequestedAtMs?: number }\n    const settled: PosHardwareOrder = { ...current }\n    delete (settled as { refundRequestedAtMs?: number }).refundRequestedAtMs\n    const refunded = withPosHardwareRefund(settled, {\n      key: `return:${stripeRefundId}`,\n      via: 'staff',\n      cents,\n      quantity: units(settled),\n      atMs: at,\n      stripeRefundId,\n    })\n    const after: PosHardwareOrder = {\n      ...refunded,\n      // Every item came back: the order is Refunded, whatever was kept.\n      status: 'refunded',\n      refundedAtMs: at,\n      returnRequest: refunded.returnRequest\n        ? { ...refunded.returnRequest, state: 'refunded', decidedBy: input.actorUid, decidedAtMs: at }\n        : refunded.returnRequest,\n    }\n    transaction.set(ref, after)\n    transaction.set(saleRef, posHardwareSaleRecord(input.orderId, after), posHardwareSaleSetOptions(after))\n    return after\n  })\n  return { before, order, cents }\n}\n\n"],"names":["formatOperatorAlertAmount","firebaseAdmin","raiseOperatorAlert","CommerceModel","posOrderRefundRecord","POS_ORDER_REFUNDS_COLLECTION","POS_STRIPE_TENDERS","formatPosHardwareCents","isPosHardwareSkuId","POS_HARDWARE_ORDER_ID","POS_HARDWARE_RETURN_REASON_MAX","posHardwareSaleRecord","posHardwareSaleSetOptions","COMMERCE_POS_HARDWARE_RETURN_REQUESTED","hardwareOrdersRef","posHardwareOrderNumber","posHardwareSaleRef","posStripe","createStripeRefund","posOrderRefundHardwareId","PosHardwareReturnRefusal","Error","message","status","firestore","app","units","order","lines","reduce","sum","line","Number","quantity","withPosHardwareRefund","refund","refunds","some","held","key","next","refundedCents","cents","returned","whole","totalCents","refundedAtMs","atMs","refundId","stripeRefundId","returnRequest","state","decidedAtMs","updatedAtMs","applyRefund","orderId","saleRef","runTransaction","transaction","sale","get","exists","ref","String","doc","snapshot","before","data","after","set","recordRegisterHardwareReturn","input","config","hostId","sellerHostId","length","register","hostRef","collection","registerOrderId","test","lineItems","productIds","Set","map","index","productId","filter","Boolean","products","Map","Promise","all","id","hardware","linesCents","Math","max","round","refundCents","hardwareCents","refunded","floor","returnId","via","now","Date","error","console","refundInPersonPosHardwareOrder","orgId","source","posSale","registerRef","card","orderPayments","payment","has","method","paymentIntentId","find","amountCents","totals","reserved","fresh","already","merge","attempt","idempotencyKey","metadata","hardwareOrderId","kind","current","catch","undefined","registerRefund","cashierId","timeline","FieldValue","arrayUnion","event","detail","registerId","POS_HARDWARE_ONLINE_RETURNABLE","requestPosHardwareReturn","reason","trim","slice","outcome","includes","created","requestedBy","uid","requestedAtMs","decidedBy","note","dedupeKey","context","orderNumber","amount","items","name","join","declinePosHardwareReturn","actorUid","posHardwareReturnRefundKey","posHardwareReturnRefundableCents","shipping","refundReturnedOnlinePosHardwareOrder","asked","fee","restockingFeeCents","isSafeInteger","claimed","stripePaymentIntentId","refundRequestedAtMs","update","params","payment_intent","ok","body","delete","at","settled"],"mappings":"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"}

package/src/lib/server/pos-hardware-sale-fields.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @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.
+ */
+export declare function posHardwareSaleFields(input: {
+    hostId: string;
+    orgId: string | null | undefined;
+    lineItems: ReadonlyArray<{
+        productId: string;
+    }>;
+    products: ReadonlyMap<string, {
+        hardwareSku?: unknown;
+    } | null | undefined>;
+}, env?: Record<string, string | undefined>): {
+    hardwareSalePending?: true;
+};