@tallyui/pos 3.8.0 → 3.9.0

package/dist/index.js

@@ -110,7 +110,7 @@ function useCurrencyCode() {
 }
 
 // src/order/woocommerce-tax.ts
-import { minorUnitDigits, woocommerceTax } from "@tallyui/core";
+import { minorUnitDigits, woocommerceTax, woocommerceCoupons } from "@tallyui/core";
 function woocommerceLine(amountMinor, rates, inclusive, currency, roundAtSubtotal, pricesIncludeTax = inclusive) {
   const dp = minorUnitDigits(currency), factor = 10 ** dp;
   const precision = woocommerceTax.getRoundingPrecision(dp);
@@ -124,17 +124,21 @@ function woocommerceLine(amountMinor, rates, inclusive, currency, roundAtSubtota
   let result = woocommerceTax.calculateTaxes(input);
   const net = woocommerceTax.roundHalfUp(input.amount - (inclusive ? result.total : 0), precision);
   if (inclusive && rates.length) result = woocommerceTax.calculateTaxes({ ...input, amount: net, amountIncludesTax: false });
-  const taxLines = result.taxes.map((tax2) => {
-    const rate = rates.find((rate2) => rate2.id === tax2.id);
+  const taxLines = result.taxes.map((tax) => {
+    const rate = rates.find((rate2) => rate2.id === tax.id);
     return {
       code: rate.code,
       rateId: rate.id,
       compound: rate.compound,
       ratePpm: Math.round(Number(rate.rate) * 1e4),
-      taxMicros: String(Math.round(tax2.total * factor * 1e6))
+      taxMicros: String(Math.round(tax.total * factor * 1e6))
     };
   });
-  const tax = result.taxes.reduce((sum, rate) => sum + (roundAtSubtotal ? rate.total : woocommerceTax.roundTaxTotal(rate.total, dp, pricesIncludeTax)), 0);
+  return lineAmounts(net, result.taxes, taxLines, dp, roundAtSubtotal, pricesIncludeTax);
+}
+function lineAmounts(net, taxes, taxLines, dp, roundAtSubtotal, pricesIncludeTax) {
+  const factor = 10 ** dp;
+  const tax = taxes.reduce((sum, rate) => sum + (roundAtSubtotal ? rate.total : woocommerceTax.roundTaxTotal(rate.total, dp, pricesIncludeTax)), 0);
   return {
     netMinor: Math.round(woocommerceTax.roundHalfUp(net, dp) * factor),
     netMicros: String(Math.round(net * factor * 1e6)),
@@ -143,6 +147,69 @@ function woocommerceLine(amountMinor, rates, inclusive, currency, roundAtSubtota
     taxMicros: taxLines.reduce((sum, rate) => sum + BigInt(rate.taxMicros), 0n).toString()
   };
 }
+function woocommerceCouponReplay(lines, codes, context, getTaxRates, currency, roundAtSubtotal, pricesIncludeTax) {
+  const dp = minorUnitDigits(currency), factor = 10 ** dp;
+  const inputLines = lines.filter((line) => line.unitPriceMinor >= 0);
+  const lineItems = inputLines.map((line) => {
+    const productId = Number(line.productId), variationId = Number(line.variantId);
+    const net = (Number(line.netMicros) / (factor * 1e6)).toFixed(6);
+    const taxes = line.taxLines.map((tax2) => {
+      const amount = (Number(tax2.taxMicros) / (factor * 1e6)).toFixed(6);
+      return { id: tax2.rateId, subtotal: amount, total: amount };
+    });
+    const tax = taxes.reduce((sum, row) => sum + Number(row.total), 0).toFixed(6);
+    return {
+      product_id: !line.custom && Number.isSafeInteger(productId) && productId >= 0 ? productId : 0,
+      ...Number.isSafeInteger(variationId) && variationId >= 0 ? { variation_id: variationId } : {},
+      quantity: line.quantity,
+      tax_class: line.taxClass ?? "",
+      ...line.taxStatus === "none" ? { tax_status: "none" } : {},
+      subtotal: net,
+      total: net,
+      taxes,
+      subtotal_tax: tax,
+      total_tax: tax
+    };
+  });
+  const taxRates = /* @__PURE__ */ new Map();
+  for (const line of inputLines) for (const rate of getTaxRates(line.taxClass)) {
+    const taxClass = woocommerceTax.normalizeTaxClass(line.taxClass);
+    taxRates.set(JSON.stringify([rate.id, taxClass]), {
+      id: rate.id,
+      rate: rate.rate,
+      compound: rate.compound,
+      order: rate.priority,
+      priority: rate.priority,
+      class: taxClass
+    });
+  }
+  const result = woocommerceCoupons.recalculateCoupons({
+    lineItems,
+    couponLines: codes.map((code) => ({ code })),
+    couponConfigs: new Map(codes.map((code) => [code, context.configs.get(code)])),
+    pricesIncludeTax,
+    calcDiscountsSequentially: context.calcDiscountsSequentially,
+    productCategories: new Map(context.productCategories),
+    taxRates: [...taxRates.values()],
+    taxRoundAtSubtotal: roundAtSubtotal,
+    dp
+  });
+  let index = 0;
+  return {
+    lines: lines.map((line) => {
+      if (line.unitPriceMinor < 0) return line;
+      const item = result.lineItems[index++];
+      const taxes = line.taxLines.map((tax) => ({ total: Number(item.taxes?.find((row) => row.id === tax.rateId)?.total ?? "0") }));
+      const taxLines = line.taxLines.map((tax, index2) => ({ ...tax, taxMicros: String(Math.round(taxes[index2].total * factor * 1e6)) }));
+      return { ...line, ...lineAmounts(Number(item.total), taxes, taxLines, dp, roundAtSubtotal, pricesIncludeTax) };
+    }),
+    coupons: result.couponLines.map((coupon, index2) => ({
+      code: codes[index2],
+      discountMinor: Math.round(woocommerceTax.roundHalfUp(Number(coupon.discount), dp) * factor),
+      discountTaxMinor: Math.round(woocommerceTax.roundHalfUp(Number(coupon.discount_tax), dp) * factor)
+    }))
+  };
+}
 function woocommerceTotals(lines, fees, shipping, currency, roundAtSubtotal, inclusive) {
   const dp = minorUnitDigits(currency), factor = 10 ** dp;
   const net = (line) => Number(line.netMicros) / (factor * 1e6);
@@ -611,7 +678,7 @@ function assertDisplayResidue(residue, convertedLines, conversions) {
   if (Math.abs(residue) > bound) throw new Error(`Display residue ${residue} exceeds its bound of ${bound} (ADR-063)`);
 }
 function createOrderBuilder(options) {
-  const { taxContext } = options;
+  const { taxContext, couponContext } = options;
   const currency = options.currency.toUpperCase();
   const orderId = options.id ?? uid();
   const woo = taxContext.rounding?.granularity === "woocommerce" && taxContext.getTaxRates ? taxContext.rounding : void 0;
@@ -628,6 +695,7 @@ function createOrderBuilder(options) {
   let payments = [];
   let customer = null;
   let note = "";
+  let couponCodes = [];
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const subject = new BehaviorSubject(buildOrder());
   function recalculateLine(line, orderDiscountMinor = 0) {
@@ -674,16 +742,26 @@ function createOrderBuilder(options) {
     return Math.max(0, Math.min(discount.value, base));
   }
   function buildOrder() {
-    const lineAmounts = lineItems.map((li) => woo ? li.unitPriceMinor * li.quantity - li.discountMinor : li.netMinor);
-    const base = lineAmounts.reduce((sum, amount) => sum + Math.max(0, amount), 0);
+    const lineAmounts2 = lineItems.map((li) => woo ? li.unitPriceMinor * li.quantity - li.discountMinor : li.netMinor);
+    const base = lineAmounts2.reduce((sum, amount) => sum + Math.max(0, amount), 0);
     let remaining = base;
     const recalcedOrderDiscounts = orderDiscounts.map((d) => {
       const amountMinor = Math.min(remaining, computeDiscountAmount(d, d.type === "percentage" ? base : remaining));
       remaining -= amountMinor;
       return { ...d, amountMinor };
     });
-    const shares = allocateOrderDiscount(lineAmounts, recalcedOrderDiscounts.reduce((sum, d) => sum + d.amountMinor, 0));
-    const lines = lineItems.map((li, index) => recalculateLine(li, shares[index]));
+    const shares = allocateOrderDiscount(lineAmounts2, recalcedOrderDiscounts.reduce((sum, d) => sum + d.amountMinor, 0));
+    const displaySourceLines = lineItems.map((li, index) => recalculateLine(li, shares[index]));
+    const replay = woo && couponCodes.length ? woocommerceCouponReplay(
+      displaySourceLines,
+      couponCodes,
+      couponContext,
+      taxContext.getTaxRates,
+      currency,
+      woo.roundAtSubtotal,
+      taxContext.pricesIncludeTax
+    ) : void 0;
+    const lines = replay?.lines ?? displaySourceLines;
     if (woo) shipping = shipping.map((charge) => ({ ...charge, ...recalculateCharge(charge.id, charge, true) }));
     const wooTotals = woo ? woocommerceTotals(lines, fees, shipping, currency, woo.roundAtSubtotal, taxContext.pricesIncludeTax) : void 0;
     const { subtotalMinor } = wooTotals ?? sumLines(lines, taxContext.rounding);
@@ -700,7 +778,7 @@ function createOrderBuilder(options) {
     }
     const discountMinor = lines.reduce((sum, li) => sum + li.discountMinor, 0);
     const taxInclusive = taxContext.pricesIncludeTax;
-    const figures = lines.map((li) => {
+    const figures = displaySourceLines.map((li) => {
       const returned = li.unitPriceMinor < 0;
       const discounts = returned ? [] : li.discounts.map((d) => ({
         discountId: d.id,
@@ -714,10 +792,11 @@ function createOrderBuilder(options) {
     });
     const displayLines = figures.map((f) => f.line);
     const orderDiscountDisplay = figures.reduce((sum, f) => sum + f.shareMinor, 0);
+    const displayCoupons = replay?.coupons.map(({ code, discountMinor: discountMinor2, discountTaxMinor }) => ({ code, amountMinor: discountMinor2 + (taxInclusive ? discountTaxMinor : 0) }));
     const displayDiscount = displayLines.reduce(
       (sum, line) => line.discounts.reduce((lineSum, d) => lineSum + d.amountMinor, sum),
       orderDiscountDisplay
-    );
+    ) + (displayCoupons?.reduce((sum, row) => sum + row.amountMinor, 0) ?? 0);
     const chargeRows = (items) => items.map(({ id: id2, name, amountMinor, netMinor, totalMinor: totalMinor2 }) => ({ id: id2, name, amountMinor: woo ? taxInclusive ? totalMinor2 : netMinor : amountMinor }));
     const displayFees = chargeRows(fees), displayShipping = chargeRows(shipping);
     let displaySubtotal = (taxInclusive ? totalMinor : totalMinor - taxMinor) + displayDiscount - [...displayFees, ...displayShipping].reduce((sum, charge) => sum + charge.amountMinor, 0);
@@ -729,11 +808,11 @@ function createOrderBuilder(options) {
       if (charge) displaySubtotal -= residue;
       residue = displaySubtotal - displayLines.reduce((sum, line) => sum + line.amountMinor, 0);
     }
-    const converted = lines.flatMap((li, index) => li.taxInclusive === taxInclusive ? [] : [index]);
+    const converted = displaySourceLines.flatMap((li, index) => li.taxInclusive === taxInclusive ? [] : [index]);
     const conversions = converted.reduce((count, index) => count + [
-      lines[index].netMinor,
-      lines[index].orderDiscountMinor,
-      ...lines[index].discounts.map((d) => d.amountMinor)
+      displaySourceLines[index].netMinor,
+      displaySourceLines[index].orderDiscountMinor,
+      ...displaySourceLines[index].discounts.map((d) => d.amountMinor)
     ].filter((x) => x !== 0).length, 0);
     assertDisplayResidue(residue, converted.length, conversions);
     let left = residue;
@@ -762,6 +841,7 @@ function createOrderBuilder(options) {
       totalMinor,
       lines: displayLines,
       orderDiscountMinor: orderDiscountDisplay,
+      ...displayCoupons ? { coupons: displayCoupons } : {},
       ...fees.length ? { fees: displayFees } : {},
       ...shipping.length ? { shipping: displayShipping } : {}
     };
@@ -772,6 +852,7 @@ function createOrderBuilder(options) {
       id: orderId,
       status: "draft",
       lineItems: lines,
+      ...replay ? { coupons: replay.coupons } : {},
       ...fees.length ? { fees: [...fees] } : {},
       ...shipping.length ? { shipping: [...shipping] } : {},
       discounts: recalcedOrderDiscounts,
@@ -1038,6 +1119,17 @@ function createOrderBuilder(options) {
       note = n;
       emit();
     },
+    setCoupons(codes) {
+      const normalized = [...new Set(codes.map((code) => code.trim().toLowerCase()))];
+      if (normalized.length && !couponContext) throw new Error("Coupon context is required");
+      for (const code of normalized) {
+        const config = couponContext.configs.get(code);
+        if (!config) throw new RangeError(`Unknown coupon ${code}`);
+        if (config.exclude_sale_items) throw new RangeError(`Coupon ${code} excludes sale items`);
+      }
+      couponCodes = normalized;
+      emit();
+    },
     clear() {
       lineItems = [];
       fees = [];
@@ -1046,6 +1138,7 @@ function createOrderBuilder(options) {
       payments = [];
       customer = null;
       note = "";
+      couponCodes = [];
       emit();
     },
     getSnapshot() {
@@ -1218,9 +1311,10 @@ var orderDraftSchema = {
   required: ["id", "data"]
 };
 async function writeOrderDraft(drafts, snapshot) {
+  const { coupons: _coupons, ...draft } = snapshot;
   await drafts.upsert({
     id: snapshot.id,
-    data: JSON.stringify(snapshot),
+    data: JSON.stringify(draft),
     customerName: snapshot.customer?.name ?? "",
     itemCount: snapshot.lineItems.length,
     total: snapshot.totalMinor,
@@ -2361,10 +2455,18 @@ function movementFieldError(input) {
 }
 
 // src/register/expected.ts
+function refundAmounts(refund) {
+  const result = refund.result;
+  if (typeof result !== "object" || result === null || Object.getPrototypeOf(result) !== Object.prototype && Object.getPrototypeOf(result) !== null) return [];
+  const byMethod = result.byMethod;
+  if (typeof byMethod !== "object" || byMethod === null || Object.getPrototypeOf(byMethod) !== Object.prototype && Object.getPrototypeOf(byMethod) !== null) return [];
+  return Object.entries(byMethod).filter(([method, amount]) => method.length > 0 && Number.isSafeInteger(amount) && amount >= 0);
+}
 function deriveExpected({
   session,
   movements,
-  ledgerRowsBySession
+  ledgerRowsBySession,
+  refunds
 }) {
   const totals = { cash: session.countedFloatMinor };
   for (const row of ledgerRowsBySession) {
@@ -2380,6 +2482,10 @@ function deriveExpected({
     if (row.type === "paid_in") totals.cash += row.amountMinor;
     if (row.type === "paid_out") totals.cash -= row.amountMinor;
   }
+  for (const refund of refunds ?? []) {
+    if (refund.status !== "applied" || refund.sessionId !== session.id) continue;
+    for (const [method, amount] of refundAmounts(refund)) totals[method] = (totals[method] ?? 0) - amount;
+  }
   return totals;
 }
 
@@ -3050,6 +3156,7 @@ async function writeClosure({
   otherTenders,
   movements,
   orders,
+  refunds,
   tillExpected,
   labels,
   resolveCashierName,
@@ -3067,6 +3174,7 @@ async function writeClosure({
     return existing;
   }
   const bound = orders.filter((order) => order.sessionId === session.id);
+  const countedRefunds = (refunds ?? []).filter((refund) => refund.status === "applied" && refund.sessionId === session.id);
   const rows = bound.flatMap(
     (order) => order.payments.map((payment) => ({
       session_id: order.sessionId,
@@ -3080,7 +3188,8 @@ async function writeClosure({
   const till_expected = tillExpected ?? deriveExpected({
     session: { id: session.id, countedFloatMinor: session.counted_float_minor },
     movements: entries,
-    ledgerRowsBySession: rows
+    ledgerRowsBySession: rows,
+    refunds
   });
   const counts = { cash: counted, ...otherTenders };
   const sum = (values) => values.reduce((total, value) => total + value, 0);
@@ -3089,6 +3198,11 @@ async function writeClosure({
     const method = row2.kind === "cash" ? "cash" : row2.method_id;
     payment_methods[method] = { sales_minor: (payment_methods[method]?.sales_minor ?? 0) + row2.amountMinor, refunds_minor: 0 };
   }
+  for (const refund of countedRefunds) {
+    for (const [method, amount] of refundAmounts(refund)) {
+      payment_methods[method] = { sales_minor: payment_methods[method]?.sales_minor ?? 0, refunds_minor: (payment_methods[method]?.refunds_minor ?? 0) + amount };
+    }
+  }
   const taxRates = /* @__PURE__ */ new Map();
   const roundings = /* @__PURE__ */ new Set();
   for (const order of bound) {
@@ -3124,7 +3238,7 @@ async function writeClosure({
       Object.entries(counts).map(([method, value]) => [method, countVariance(value, till_expected[method] ?? 0)])
     ),
     period_sales_total_minor: sum(rows.map((row2) => row2.amountMinor)),
-    period_refunds_total_minor: 0,
+    period_refunds_total_minor: sum(countedRefunds.flatMap((refund) => refundAmounts(refund).map(([, amount]) => amount))),
     perpetual_sales_total_minor: 0,
     perpetual_refunds_total_minor: 0,
     unsynced_count: unsynced.length,
@@ -3161,7 +3275,11 @@ async function writeClosure({
         voided_by: voided_by ?? null
       })),
       transaction_count: bound.length,
-      refund_count: 0,
+      refund_count: countedRefunds.length,
+      ...refunds !== void 0 ? {
+        refund_ids: countedRefunds.map((refund) => refund.id),
+        pending_refund_ids: refunds.filter((refund) => refund.status === "pending" && refund.sessionId === session.id).map((refund) => refund.id)
+      } : {},
       cashiers: [...new Set(bound.map((order) => order.cashierRef ?? "").filter(Boolean))].map((id2) => ({
         id: id2,
         name: resolveCashierName?.(id2) || id2
@@ -3788,7 +3906,8 @@ async function adoptRegisterResults({ commands, sessions, registerId }) {
   chains2.set(commands, run.then(() => void 0, () => void 0));
   return run;
 }
-async function takeOverSession({ commands, sessions, sessionId, now }) {
+async function takeOverSession({ commands, sessions, sessionId, now, registerContract }) {
+  if ((registerContract ?? 0) < 2) throw new RegisterTakeOverError("REGISTER_TAKEOVER_UNSUPPORTED");
   const run = (chains2.get(commands) ?? Promise.resolve()).then(async () => {
     const [session] = await readFresh(sessions, { selector: { id: sessionId } });
     const row = await commands.findOne(`session.open:${sessionId}`).exec();
@@ -3888,7 +4007,7 @@ function ledgerRows(orders) {
 }
 function useRegisterSession(options) {
   const { sessions, movements, closures, orders, register, storeKey, registerId, enabled, actor, timezone, tenderInProgress, expectedCloseTime, labels } = options;
-  const { commands } = options;
+  const { commands, refunds } = options;
   const commandEnabled = (options.capabilities?.register ?? 0) >= 1;
   const commandTarget = useMemo3(
     () => enabled && commandEnabled && commands && sessions && movements && closures && register && registerId ? { commands, sessions, movements, closures, host: register, storeKey, registerId, registerContract: options.capabilities?.register, deviceName: options.deviceName } : null,
@@ -3915,21 +4034,22 @@ function useRegisterSession(options) {
     return () => subscription.unsubscribe();
   }, [commandTarget]);
   const source = useMemo3(() => {
-    if (!enabled || !sessions || !movements || !closures || !orders || !registerId || !register) return null;
+    if (!enabled || !sessions || !movements || !closures || !orders || !registerId || !register || refunds === null) return null;
     return combineLatest([
       watchFresh(sessions, { selector: { register_id: registerId } }),
       watchFresh(closures, { selector: { register_id: registerId } }),
       observeRegister$(register).pipe(map5((document) => reservationOf(document, storeKey, registerId)))
     ]).pipe(switchMap(([rows, closureRows, reservation]) => {
       const current2 = currentSession(rows, closureRows, reservation);
-      if (!current2) return of({ rows, closureRows, reservation, entries: [], sales: [] });
+      if (!current2) return of({ rows, closureRows, reservation, entries: [], sales: [], refundRows: [] });
       return combineLatest([
         watchFresh(movements, { selector: { session_id: current2.id } }),
         watchFresh(orders, { selector: { sessionId: current2.id } }),
-        commandTarget ? watchFresh(commandTarget.commands, { selector: { key: `session.open:${current2.id}` } }) : of([])
-      ]).pipe(map5(([entries2, sales2, opens]) => ({ rows, closureRows, reservation, entries: entries2, sales: sales2, open: opens[0] })));
+        commandTarget ? watchFresh(commandTarget.commands, { selector: { key: `session.open:${current2.id}` } }) : of([]),
+        refunds ? watchFresh(refunds, { selector: { sessionId: current2.id } }) : of([])
+      ]).pipe(map5(([entries2, sales2, opens, refundRows]) => ({ rows, closureRows, reservation, entries: entries2, sales: sales2, open: opens[0], refundRows })));
     }));
-  }, [enabled, sessions, movements, closures, orders, register, storeKey, registerId, commandTarget]);
+  }, [enabled, sessions, movements, closures, orders, register, storeKey, registerId, commandTarget, refunds]);
   const tender = useRef2(tenderInProgress);
   tender.current = tenderInProgress;
   const closing = useSyncExternalStore(subscribeClosing, () => closingByRegister.has(registerId ?? ""));
@@ -3988,7 +4108,7 @@ function useRegisterSession(options) {
   const conflict = session?.status !== "conflict" || !commandTarget ? void 0 : data?.open?.syncStatus === "pending" && typeof data.open.payload.supersedes === "string" ? { sessionId: data.open.payload.supersedes, takingOver: true } : data?.open?.syncStatus === "rejected" && refusal ? { sessionId: refusal.sessionId, openedAt: refusal.openedAt, openedBy: refusal.openedBy, deviceName: refusal.deviceName, takingOver: false } : void 0;
   const entries = data?.entries ?? [];
   const sales = data?.sales ?? [];
-  const expected = session ? deriveExpected({ session: { id: session.id, countedFloatMinor: session.counted_float_minor }, movements: entries, ledgerRowsBySession: ledgerRows(sales) }) : {};
+  const expected = session ? deriveExpected({ session: { id: session.id, countedFloatMinor: session.counted_float_minor }, movements: entries, ledgerRowsBySession: ledgerRows(sales), refunds: data?.refundRows ?? [] }) : {};
   const now = /* @__PURE__ */ new Date();
   const [hour, minute] = String(expectedCloseTime ?? "").split(":").map(Number);
   const overdue = session?.status === "open" && !!expectedCloseTime && now.getTime() > new Date(now.getFullYear(), now.getMonth(), now.getDate(), hour, minute).getTime();
@@ -3998,8 +4118,8 @@ function useRegisterSession(options) {
     return id2 === null ? null : { id: id2, sessions };
   };
   const live = () => {
-    if (!enabled || !sessions || !movements || !closures || !orders || !registerId || !register) throw new RegisterSessionRequiredError();
-    return { sessions, movements, closures, orders, registerId, register };
+    if (!enabled || !sessions || !movements || !closures || !orders || !registerId || !register || refunds === null) throw new RegisterSessionRequiredError();
+    return { sessions, movements, closures, orders, registerId, register, refunds };
   };
   const current = () => {
     if (!session) throw new RegisterSessionRequiredError();
@@ -4041,8 +4161,7 @@ function useRegisterSession(options) {
           reservationOf(await readRegister(commandTarget.host), commandTarget.storeKey, commandTarget.registerId)
         );
         if (row?.status !== "conflict") throw new RegisterSessionRequiredError();
-        if ((options.capabilities?.register ?? 0) < 2) throw new RegisterTakeOverError("REGISTER_TAKEOVER_UNSUPPORTED");
-        await takeOverSession({ ...commandTarget, sessionId: row.id });
+        await takeOverSession({ ...commandTarget, sessionId: row.id, registerContract: options.capabilities?.register });
       },
       chooseAnotherRegister: async () => {
         if (!commandTarget) throw new RegisterSessionRequiredError();
@@ -4137,7 +4256,7 @@ function useRegisterSession(options) {
         const key = registerId ?? "";
         if (closingByRegister.has(key)) return closingByRegister.get(key);
         const run = (async () => {
-          const { sessions: sessions2, movements: movements2, closures: closures2, orders: orders2, register: register2 } = live();
+          const { sessions: sessions2, movements: movements2, closures: closures2, orders: orders2, register: register2, refunds: refunds2 } = live();
           const open = current();
           const stored = await readSession(sessions2, open.id);
           if (!stored) throw new RegisterSessionRequiredError();
@@ -4145,7 +4264,8 @@ function useRegisterSession(options) {
             const fresh = deriveExpected({
               session: { id: stored.id, countedFloatMinor: stored.counted_float_minor },
               movements: await readFresh(movements2, { selector: { session_id: stored.id } }),
-              ledgerRowsBySession: ledgerRows(await readFresh(orders2, { selector: { sessionId: stored.id } }))
+              ledgerRowsBySession: ledgerRows(await readFresh(orders2, { selector: { sessionId: stored.id } })),
+              refunds: refunds2 ? await readFresh(refunds2, { selector: { sessionId: stored.id } }) : void 0
             });
             if (closeNeedsApproval(input.counted.cash ?? 0, fresh.cash ?? 0, options.varianceThreshold)) throw new RegisterApprovalRequiredError();
           }
@@ -4163,6 +4283,7 @@ function useRegisterSession(options) {
             softwareVersion: options.softwareVersion,
             movements: await readFresh(movements2, { selector: { session_id: closed.id } }),
             orders: await readFresh(orders2, { selector: { sessionId: closed.id } }),
+            refunds: refunds2 ? await readFresh(refunds2, { selector: { sessionId: closed.id } }) : void 0,
             resolveCashierName: labels?.resolveCashierName,
             labels: {
               register_name: labels?.registerName ?? "",
@@ -5771,6 +5892,148 @@ function useOrderOutbox(options) {
   };
 }
 
+// src/refund/send-order-refund.ts
+import { parseCommandResult } from "@tallyui/core/server";
+async function sendOrderRefund(transport, envelope2) {
+  let outcome;
+  try {
+    outcome = await transport.send([envelope2]);
+  } catch {
+    return { kind: "unknown", reason: "transport_error" };
+  }
+  if (outcome.kind === "retry") {
+    return {
+      kind: "unknown",
+      reason: outcome.reason,
+      ...outcome.retryAfterMs !== void 0 ? { retryAfterMs: outcome.retryAfterMs } : {}
+    };
+  }
+  if (outcome.kind === "refused" || outcome.kind === "unauthorized") return outcome;
+  const matches = outcome.results.filter((result2) => result2.id === envelope2.id);
+  if (matches.length !== 1) return { kind: "unknown", reason: "missing_result" };
+  let result;
+  try {
+    result = parseCommandResult(matches[0]);
+  } catch {
+    return { kind: "unknown", reason: "bad_result" };
+  }
+  if (result.status === "applied" || result.status === "duplicate") {
+    if (!result.refund) return { kind: "unknown", reason: "bad_result" };
+    return { kind: "applied", refund: result.refund, duplicate: result.status === "duplicate" };
+  }
+  return { kind: "rejected", error: result.error };
+}
+
+// src/refund/pos-refund.ts
+var posRefundSchema = {
+  title: "POS refunds",
+  version: 0,
+  primaryKey: "id",
+  type: "object",
+  additionalProperties: false,
+  properties: {
+    id: { type: "string", maxLength: 64 },
+    commandId: { type: "string", maxLength: 64 },
+    orderId: { type: "string", maxLength: 64 },
+    sessionId: { type: "string", maxLength: 64 },
+    registerId: { type: "string", maxLength: 64 },
+    envelope: { type: "object", additionalProperties: true },
+    status: { type: "string", enum: ["pending", "applied", "rejected", "unsent"], maxLength: 10 },
+    result: { type: "object", additionalProperties: true },
+    duplicate: { type: "boolean" },
+    error: { type: "object", properties: {
+      code: { type: "string" },
+      message: { type: "string" },
+      data: { type: "object", additionalProperties: true }
+    }, required: ["code", "message"], additionalProperties: false },
+    createdAt: { type: "string" },
+    updatedAt: { type: "string" }
+  },
+  required: ["id", "commandId", "orderId", "sessionId", "registerId", "envelope", "status", "createdAt", "updatedAt"],
+  indexes: [["sessionId"]]
+};
+var posRefundCollection = () => ({ schema: posRefundSchema });
+
+// src/refund/submit-order-refund.ts
+import { RxError } from "rxdb";
+var RefundAnswerPendingError = class extends Error {
+  constructor(record) {
+    super("This refund's answer is still unknown. Send it again before trying a new refund attempt.");
+    this.record = record;
+    this.name = "RefundAnswerPendingError";
+  }
+  code = "REFUND_ANSWER_PENDING";
+};
+async function submitOrderRefund({ refunds, transport, envelope: envelope2, now = () => (/* @__PURE__ */ new Date()).toISOString() }) {
+  const id2 = envelope2.payload.clientRefundId;
+  let doc = await refunds.findOne(id2).exec();
+  if (!doc) {
+    const at2 = now();
+    const { orderId, sessionId, registerId } = envelope2.payload;
+    try {
+      doc = await refunds.insert({
+        id: id2,
+        commandId: envelope2.id,
+        orderId,
+        sessionId,
+        registerId,
+        envelope: envelope2,
+        status: "pending",
+        createdAt: at2,
+        updatedAt: at2
+      });
+    } catch (error) {
+      if (!(error instanceof RxError) || error.code !== "CONFLICT") throw error;
+      doc = await refunds.findOne(id2).exec();
+    }
+  }
+  let record = doc.toJSON();
+  for (let pass = 0; ; pass++) {
+    if (pass === 2) throw new RefundAnswerPendingError(record);
+    if (record.status === "applied") {
+      return { outcome: { kind: "applied", refund: record.result, duplicate: true }, record };
+    }
+    if (record.status === "pending") {
+      if (record.commandId !== envelope2.id) throw new RefundAnswerPendingError(record);
+      break;
+    }
+    if (record.status === "rejected" && record.commandId === envelope2.id) {
+      return { outcome: { kind: "rejected", error: record.error }, record };
+    }
+    if (record.status === "unsent" && record.commandId === envelope2.id) {
+      doc = await doc.incrementalModify((stored) => {
+        if (stored.status !== "unsent" || stored.commandId !== envelope2.id) return stored;
+        const { error, ...rest } = stored;
+        return { ...rest, status: "pending", updatedAt: now() };
+      });
+      record = doc.toJSON();
+      continue;
+    }
+    doc = await doc.incrementalModify((stored) => {
+      if (stored.status !== "rejected" && stored.status !== "unsent") return stored;
+      const { result, duplicate, error, ...rest } = stored;
+      return { ...rest, commandId: envelope2.id, envelope: envelope2, status: "pending", updatedAt: now() };
+    });
+    record = doc.toJSON();
+    if (record.commandId === envelope2.id) break;
+  }
+  const outcome = await sendOrderRefund(transport, envelope2);
+  if (outcome.kind !== "unknown") {
+    doc = await doc.incrementalModify((stored) => {
+      if (stored.status !== "pending" || stored.commandId !== envelope2.id) return stored;
+      const updatedAt = now();
+      if (outcome.kind === "applied") {
+        const { error: error2, ...rest } = stored;
+        return { ...rest, status: "applied", result: outcome.refund, duplicate: outcome.duplicate, updatedAt };
+      }
+      if (outcome.kind === "rejected") return { ...stored, status: "rejected", error: outcome.error, updatedAt };
+      const error = outcome.kind === "refused" ? { code: "refused", message: outcome.reason, data: { status: outcome.status } } : { code: "unauthorized", message: "unauthorized" };
+      return { ...stored, status: "unsent", error, updatedAt };
+    });
+  }
+  return { outcome, record: doc.getLatest().toJSON() };
+}
+
 // src/tender/tender-state.ts
 var MAX_TENDER_MINOR = 999999999;
 var initialTenderState = {
@@ -6016,6 +6279,7 @@ export {
   PosOrderOpenClosedError,
   RECEIPT_SCHEMA_VERSION,
   REGISTER_SESSION_MIGRATION_CLOSE_WAIT_MS,
+  RefundAnswerPendingError,
   RegisterApprovalRequiredError,
   RegisterCloseIncompleteError,
   RegisterIdInvalidError,
@@ -6111,6 +6375,8 @@ export {
   posOrderCollection,
   posOrderSchema,
   posOrdersLogger,
+  posRefundCollection,
+  posRefundSchema,
   productCategories,
   productSortValue,
   quickTenderedAmounts,
@@ -6137,6 +6403,7 @@ export {
   sameSale,
   searchProducts,
   selectClosureRows,
+  sendOrderRefund,
   sessionOpenCommand,
   sessionTransitionCommand,
   sortProducts,
@@ -6144,6 +6411,7 @@ export {
   startCounting,
   stockOverlay$,
   stockOverlayAsOf$,
+  submitOrderRefund,
   takeOverSession,
   taxFiguresForBasket,
   taxLinesByRate,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tallyui/pos",
-  "version": "3.8.0",
+  "version": "3.9.0",
   "type": "module",
   "description": "Shared POS business logic for Tally UI — tax, orders, payments, discounts, receipts",
   "main": "./dist/index.js",
@@ -10,7 +10,8 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "source": "./src/index.ts"
+      "source": "./src/index.ts",
+      "default": "./dist/index.js"
     }
   },
   "files": [
@@ -27,20 +28,20 @@
     "directory": "packages/pos"
   },
   "peerDependencies": {
-    "@tallyui/core": "^3.8.0",
+    "@tallyui/core": "^3.9.0",
     "react": ">=18",
     "rxdb": "~17.5.0",
     "rxjs": ">=7"
   },
   "devDependencies": {
-    "@tallyui/core": "3.8.0",
+    "@tallyui/core": "3.9.0",
     "@types/react": ">=18",
     "react": "^19.2.4",
     "rxdb": "17.5.0",
     "rxjs": "7.8.2",
-    "@tallyui/connector-medusa": "3.8.0",
-    "@tallyui/connector-woocommerce": "3.8.0",
-    "@tallyui/database": "3.8.0"
+    "@tallyui/connector-medusa": "3.9.0",
+    "@tallyui/connector-woocommerce": "3.9.0",
+    "@tallyui/database": "3.9.0"
   },
   "scripts": {
     "build": "tsup",