rerobe-js-orm 4.9.8 → 4.9.10

package/lib/helpers/OrderHelpers.js

@@ -742,16 +742,30 @@ class OrderHelpers {
                 fractionDigits: 2,
             }),
             refundLineItems: (order.refunds || []).flatMap((refund) => (refund.refundLineItems || []).map((item) => {
-                var _a, _b;
-                return ({
-                    title: item.title || '',
-                    quantity: item.quantity || 1,
+                var _a, _b, _c, _d, _e, _f, _g, _h;
+                // A stored RefundLineItem is { lineItem, quantityRefund,
+                // quantityCancel, subtotalRefund(Presentment), subtotalCanceled(
+                // Presentment) } — the title/amount live on `lineItem`, not flat on
+                // the item. Returned units = refunded + canceled (a cancellation of
+                // unfulfilled units still returns money). The subtotals are net of
+                // tax (originalUnitPrice basis), so gross them up for the receipt.
+                const lineItem = item.lineItem || {};
+                const quantity = Number(item.quantityRefund || 0) + Number(item.quantityCancel || 0);
+                const net = Number((_d = (_b = (_a = item.subtotalRefundPresentment) === null || _a === void 0 ? void 0 : _a.amount) !== null && _b !== void 0 ? _b : (_c = item.subtotalRefund) === null || _c === void 0 ? void 0 : _c.amount) !== null && _d !== void 0 ? _d : 0) +
+                    Number((_h = (_f = (_e = item.subtotalCanceledPresentment) === null || _e === void 0 ? void 0 : _e.amount) !== null && _f !== void 0 ? _f : (_g = item.subtotalCanceled) === null || _g === void 0 ? void 0 : _g.amount) !== null && _h !== void 0 ? _h : 0);
+                const taxRate = Number(lineItem.taxRate || 0);
+                const gross = lineItem.isTaxable && taxRate ? net * (1 + taxRate) : net;
+                return {
+                    title: (0, MarketplaceLineDisplayHelpers_1.formatMarketplaceLineDisplayTitle)({ lineItem }, { includeSellerPrefix: includeMarketplaceSellerPrefix }) ||
+                        lineItem.title ||
+                        '',
+                    quantity,
                     price: (0, Utilities_1.formatPrice)({
                         currencyCode,
-                        amount: -Number(((_a = item.presentmentTotalPrice) === null || _a === void 0 ? void 0 : _a.amount) || ((_b = item.totalPrice) === null || _b === void 0 ? void 0 : _b.amount) || 0),
+                        amount: -Math.abs(gross),
                         fractionDigits: 2,
                     }),
-                });
+                };
             })),
         }));
     }

package/lib/helpers/ReceiptXmlHelpers.d.ts

@@ -1,6 +1,16 @@
+export type ReceiptPreviewLine = {
+    align: 'left' | 'center' | 'right';
+    bold: boolean;
+    size: number;
+    text: string;
+    cut?: boolean;
+};
 export default class ReceiptXmlHelpers {
     static escapeXML(text: any): string;
     private static variantLabelForReceipt;
     static formatLineItemXML(lineItem: any): string;
     static buildReceiptContentXML(receiptData: any): string;
+    private static decodeXML;
+    private static parseAttrs;
+    static parseReceiptXml(xml: string): ReceiptPreviewLine[];
 }

package/lib/helpers/ReceiptXmlHelpers.js

@@ -231,5 +231,89 @@ class ReceiptXmlHelpers {
         receipt += '</epos-print>';
         return receipt;
     }
+    // Decode the 5 XML entities escapeXML produces, back to their characters.
+    // `&amp;` is decoded last so `&amp;lt;` round-trips to `&lt;`, not `<`.
+    static decodeXML(text) {
+        return String(text)
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&quot;/g, '"')
+            .replace(/&#39;/g, "'")
+            .replace(/&amp;/g, '&');
+    }
+    // Parse `attr="value"` pairs out of a tag's attribute string.
+    static parseAttrs(raw) {
+        const attrs = {};
+        const re = /(\w+)="([^"]*)"/g;
+        let m = re.exec(raw);
+        while (m) {
+            attrs[m[1]] = m[2];
+            m = re.exec(raw);
+        }
+        return attrs;
+    }
+    // Inverse of buildReceiptContentXML for PREVIEW rendering: turn the exact
+    // ePOS-Print XML the printer receives into an ordered list of styled lines, so
+    // a simulator can render byte-for-byte what will print without re-deriving the
+    // layout from raw receipt fields (which silently drifts when a field is added).
+    //
+    // ePOS-Print printer state (align, double width/height, emphasis) is sticky —
+    // it persists across <text> elements until changed — so we carry it forward.
+    // <feed/> ends a line; <cut/> is emitted as a cut marker. Spaces are preserved
+    // verbatim (line items pad to a fixed column width), so render with a
+    // fixed-width font and white-space: pre to reproduce the columns.
+    //
+    // Returns styled lines ({ align, bold, size (1|2), text, cut? }) in print order.
+    static parseReceiptXml(xml) {
+        const lines = [];
+        if (!xml)
+            return lines;
+        // Sticky printer state.
+        let align = 'left';
+        let bold = false;
+        let size = 1;
+        // Current line buffer (reflects the state at the time text was appended).
+        let buf = '';
+        let hasText = false;
+        const flush = () => {
+            lines.push({ align, bold, size, text: buf });
+            buf = '';
+            hasText = false;
+        };
+        const tokenRe = /<text\b([^>]*?)\/>|<text\b([^>]*)>([\s\S]*?)<\/text>|<feed\s*\/>|<cut\b[^>]*?\/>/g;
+        let t = tokenRe.exec(xml);
+        while (t) {
+            const whole = t[0];
+            if (whole.indexOf('<feed') === 0) {
+                flush();
+            }
+            else if (whole.indexOf('<cut') === 0) {
+                if (hasText || buf)
+                    flush();
+                lines.push({ align: 'center', bold: false, size: 1, text: '', cut: true });
+            }
+            else {
+                // A <text> element: self-closing (state only) or with content.
+                const selfClosing = t[1] !== undefined;
+                const attrs = this.parseAttrs(selfClosing ? t[1] : t[2]);
+                if (attrs.align === 'left' || attrs.align === 'center' || attrs.align === 'right') {
+                    align = attrs.align;
+                }
+                if (attrs.width)
+                    size = parseInt(attrs.width, 10) >= 2 ? 2 : 1;
+                if (attrs.em !== undefined)
+                    bold = attrs.em === 'true';
+                if (!selfClosing && t[3]) {
+                    buf += this.decodeXML(t[3]);
+                    hasText = true;
+                }
+            }
+            t = tokenRe.exec(xml);
+        }
+        // Trailing content with no closing <feed/>.
+        if (hasText || buf)
+            flush();
+        return lines;
+    }
 }
 exports.default = ReceiptXmlHelpers;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rerobe-js-orm",
-  "version": "4.9.8",
+  "version": "4.9.10",
   "description": "ReRobe's Javascript ORM Framework",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",