washday-sdk 1.0.2 → 1.1.1

package/dist/utils/orders/calculateTotalTaxesOverPrice.js

@@ -1,36 +1,40 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateTotalTaxesOverPrice = void 0;
-const enum_1 = require("../../enum");
-const helpers_1 = require("./helpers");
-const calculateTotalTaxesOverPrice = (order, selectedCustomer, storeSettings, storeDiscounts, appliedOrderDiscounts, discountCodeObj) => {
+import { BuyAndGetConditionsTypes, DiscountCodeTypes } from "../../enum";
+import { getProductTaxesPercentage } from "./helpers";
+export const calculateTotalTaxesOverPrice = (order, selectedCustomer, storeSettings, storeDiscounts, appliedOrderDiscounts, discountCodeObj) => {
     const productTableImports = [...order.products, ...order.buyAndGetProducts].map((current) => {
         var _a;
         let discPercentageInteger = 0;
         let productPercentageDiscount = 0;
         let customerDiscount = 0;
-        let qty = current.qty;
-        // extraAmount es en general sin importar el qty, entonces aqui lo repartimos por igual
-        const extraAmountPerUnit = current.extraAmount / qty;
-        const prodPrice = (order.express ? current.expressPrice : current.price) + extraAmountPerUnit;
+        const qty = current.qty || current.quantity; // cantidad
+        // Precio base sin impuestos (en modo over_price el precio es neto)
+        const productBasePrice = order.express ? current.expressPrice : current.price;
+        // === NUEVO: Considerar extraAmount en el precio a descontar ===
+        // extraAmount es el ajuste total para la línea; se reparte por unidad
+        const extraAmount = current.extraAmount || 0;
+        const unitExtra = qty > 0 ? extraAmount / qty : 0;
+        // Precio ajustado: suma del precio base y el extra por unidad
+        const adjustedPrice = productBasePrice + unitExtra;
+        // Cálculo de descuento sobre el precio ajustado
         if (!order.discountCode) {
-            //IF ORDER HAS A DISCOUNT CODE WE DON'T APPLY ANY OTHER DISCOUNT (AUTOMATICALLY OR CUSTOMER DISCOUNT)
-            //THIS WILL GET THE DISCOUNTS OF THE CURRENT PRODUCT
-            // get store discounts if product applies and customer discount
-            const discountsToApply = storeDiscounts.filter((discount) => discount.products.includes(current._id) && discount.isActive);
-            customerDiscount = ((_a = selectedCustomer === null || selectedCustomer === void 0 ? void 0 : selectedCustomer.customer) === null || _a === void 0 ? void 0 : _a.discount) || 0;
-            productPercentageDiscount = discountsToApply.reduce((prev, next) => {
-                if (next.type === 'percentage') {
-                    // for now we just sum percetange type discounts
-                    return prev + next.value;
+            const discountsToApply = storeDiscounts.filter((discount) => discount.isActive && discount.products.some((p) => {
+                if (typeof p === 'string') {
+                    return p === current._id;
+                }
+                else if (typeof p === 'object') {
+                    return p._id === current._id;
                 }
-                return prev;
+                return false;
+            }));
+            customerDiscount = ((_a = selectedCustomer === null || selectedCustomer === void 0 ? void 0 : selectedCustomer.customer) === null || _a === void 0 ? void 0 : _a.discount) || 0;
+            productPercentageDiscount = discountsToApply.reduce((acc, discount) => {
+                return discount.type === 'percentage' ? acc + discount.value : acc;
             }, 0);
             discPercentageInteger = +((productPercentageDiscount + customerDiscount) / 100).toFixed(2);
-            discountsToApply.forEach((discount) => (appliedOrderDiscounts[discount._id] = discount)); // it will do this for every product, if two products has the same discount it will just overwrite
+            discountsToApply.forEach((discount) => (appliedOrderDiscounts[discount._id] = discount));
         }
         else {
-            if (discountCodeObj.type === enum_1.DiscountCodeTypes.PERCENTAGE) {
+            if (discountCodeObj.type === DiscountCodeTypes.PERCENTAGE) {
                 discPercentageInteger = +(discountCodeObj.value / 100).toFixed(2);
                 if (!discountCodeObj.applyToAllProducts) {
                     discPercentageInteger = discountCodeObj.products.includes(current._id)
@@ -38,37 +42,44 @@ const calculateTotalTaxesOverPrice = (order, selectedCustomer, storeSettings, st
                         : 0;
                 }
             }
-            if (discountCodeObj.type === enum_1.DiscountCodeTypes.BUY_X_GET_Y) {
-                const discountType = discountCodeObj.buyAndGetConditions[0].getDiscountType;
-                const discountValue = discountCodeObj.buyAndGetConditions[0].discountValue;
-                if (discountType === enum_1.BuyAndGetConditionsTypes.PERCENTAGE && current.isBuyAndGetProduct) {
-                    discPercentageInteger = +(discountValue / 100).toFixed(2);
+            else if (discountCodeObj.type === DiscountCodeTypes.BUY_X_GET_Y) {
+                const condition = discountCodeObj.buyAndGetConditions[0];
+                if (condition.getDiscountType === BuyAndGetConditionsTypes.PERCENTAGE && current.isBuyAndGetProduct) {
+                    discPercentageInteger = +(condition.discountValue / 100).toFixed(2);
                 }
+                if (condition.getDiscountType === BuyAndGetConditionsTypes.FREE && current.isBuyAndGetProduct) {
+                    discPercentageInteger = 1;
+                }
+            }
+            else if (discountCodeObj.type === DiscountCodeTypes.FREE_ITEM && current.isFreeItem) {
+                discPercentageInteger = 1;
             }
         }
-        //GET DISCOUNT AMOUNT (IN CASE discPercentageInteger is 0 it could be a discount of a integer number)
-        const discountAmountPerUnit = discPercentageInteger
-            ? prodPrice * discPercentageInteger
-            : (current.discountAmount || 0);
-        //GET PRODUCT PRICE WITH DISCOUNT
-        const prodPriceWithDiscountPerUnit = prodPrice - discountAmountPerUnit;
-        //GET PRODUCT TAXES APPLIED TO FINAL PRICE PER UNIT
-        const taxPercentage = (0, helpers_1.getProductTaxesPercentage)(current, storeSettings);
-        const taxPercentageInteger = taxPercentage / 100;
-        const prodPriceWithoutTaxesPerUnit = prodPriceWithDiscountPerUnit;
-        const taxesAmountPerUnit = prodPriceWithoutTaxesPerUnit * taxPercentageInteger;
-        const totalTaxesApplied = +(taxesAmountPerUnit * qty).toFixed(2);
-        let lineDiscount = qty * discountAmountPerUnit;
-        let prodLinePriceWithDiscount = +(qty * prodPriceWithDiscountPerUnit).toFixed(2);
+        // Calcular el descuento por unidad sobre el precio ajustado
+        const productDiscount = adjustedPrice * discPercentageInteger;
+        const discountedAdjustedPrice = adjustedPrice - productDiscount;
+        // Subtotal para la línea (precio descontado por unidad * cantidad) SIN impuestos
+        const subtotal = discountedAdjustedPrice * qty;
+        // Calcular impuestos sobre el subtotal
+        const taxPercentage = getProductTaxesPercentage(current, storeSettings) / 100;
+        const taxes = subtotal * taxPercentage;
+        // Resultados finales:
+        const totalTaxesApplied = +taxes.toFixed(2);
+        const lineDiscount = +(productDiscount * qty).toFixed(2);
+        // Precio total con descuento, reaplicando impuestos
+        const prodLinePriceWithDiscount = +((subtotal * (1 + taxPercentage))).toFixed(2);
         return {
             product: current,
-            qty: qty,
-            productLineImportTotal: prodPrice * qty, //this is line without discount
+            qty,
+            // Total bruto original sin descuento: (precio base * cantidad) + extraAmount
+            productLineImportTotal: (productBasePrice * qty) + extraAmount,
+            // Total final con descuento, con impuestos incluidos
             productLineTotalWithDiscount: prodLinePriceWithDiscount,
             productLineTaxesTotal: totalTaxesApplied,
-            lineDiscountAmount: lineDiscount
+            lineDiscountAmount: lineDiscount,
+            // Subtotal neto (sin impuestos) con descuento aplicado
+            productLineSubtotal: subtotal
         };
     });
     return productTableImports;
 };
-exports.calculateTotalTaxesOverPrice = calculateTotalTaxesOverPrice;

package/dist/utils/orders/helpers.js

@@ -1,8 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCreditApplied = exports.getShippingCost = exports.getProductLineTotals = exports.getProductTaxesPercentage = void 0;
-const enum_1 = require("../../enum");
-const getProductTaxesPercentage = (productObj, store) => {
+import { BuyAndGetConditionsTypes, DiscountCodeTypes } from "../../enum";
+export const getProductTaxesPercentage = (productObj, store) => {
     const getTaxValue = (tax, isTaxExempt) => {
         if (!tax) {
             // If no store tax configured, always return 0
@@ -15,13 +12,12 @@ const getProductTaxesPercentage = (productObj, store) => {
         // If store tax configured and taxExempt is false, return store tax
         return tax.value;
     };
-    const tax1 = getTaxValue(store.taxOne, !productObj.taxExemptOne);
-    const tax2 = getTaxValue(store.taxTwo, !productObj.taxExemptTwo);
-    const tax3 = getTaxValue(store.taxThree, !productObj.taxExemptThree);
+    const tax1 = getTaxValue(store.taxOne, productObj.taxExemptOne);
+    const tax2 = getTaxValue(store.taxTwo, productObj.taxExemptTwo);
+    const tax3 = getTaxValue(store.taxThree, productObj.taxExemptThree);
     return tax1 + tax2 + tax3;
 };
-exports.getProductTaxesPercentage = getProductTaxesPercentage;
-const getProductLineTotals = (productLinesTotals) => {
+export const getProductLineTotals = (productLinesTotals) => {
     const totalQuantity = +productLinesTotals.reduce((acum, line) => acum + line.qty, 0).toFixed(2);
     const totalImportWithDiscount = +productLinesTotals
         .reduce((acum, line) => acum + line.productLineTotalWithDiscount, 0)
@@ -35,25 +31,27 @@ const getProductLineTotals = (productLinesTotals) => {
     const totalDiscountAmount = +productLinesTotals
         .reduce((acum, line) => acum + line.lineDiscountAmount, 0)
         .toFixed(2);
+    const totalSubtotalAmount = +productLinesTotals
+        .reduce((acum, line) => acum + line.productLineSubtotal, 0)
+        .toFixed(2);
     return {
         totalQuantity,
         totalImportWithDiscount,
         totalImportWithoutDiscount,
         totalImporTaxes,
-        totalDiscountAmount
+        totalDiscountAmount,
+        totalSubtotalAmount
     };
 };
-exports.getProductLineTotals = getProductLineTotals;
-const getShippingCost = (discountObject, requireShippingService, store) => {
+export const getShippingCost = (discountObject, requireShippingService, store) => {
     var _a, _b;
     const shippingCost = requireShippingService ? (_b = (_a = store === null || store === void 0 ? void 0 : store.orderPageConfig) === null || _a === void 0 ? void 0 : _a.shippingServiceCost) !== null && _b !== void 0 ? _b : 0 : 0;
-    if ((discountObject === null || discountObject === void 0 ? void 0 : discountObject.type) === enum_1.DiscountCodeTypes.FREE_DELIVERY) {
+    if ((discountObject === null || discountObject === void 0 ? void 0 : discountObject.type) === DiscountCodeTypes.FREE_DELIVERY) {
         return 0;
     }
     return shippingCost;
 };
-exports.getShippingCost = getShippingCost;
-const getCreditApplied = (selectedCustomer, orderTotal) => {
+export const getCreditApplied = (selectedCustomer, orderTotal) => {
     var _a, _b;
     const customerCredit = (_b = (_a = selectedCustomer === null || selectedCustomer === void 0 ? void 0 : selectedCustomer.customer) === null || _a === void 0 ? void 0 : _a.credit) !== null && _b !== void 0 ? _b : 0;
     if (customerCredit === 0 || !selectedCustomer) {
@@ -61,4 +59,115 @@ const getCreditApplied = (selectedCustomer, orderTotal) => {
     }
     return Math.min(customerCredit, orderTotal);
 };
-exports.getCreditApplied = getCreditApplied;
+export const applyDiscountToProducts = (discountCode, productsArr, isExpress, storeDiscounts = [], selectedCustomer = { discount: 0 }) => {
+    if (!discountCode) {
+        // Caso sin discountCode: se aplican descuentos automáticos solo sobre el precio del producto
+        return {
+            newOrderProds: productsArr.map((prod) => {
+                const discountsToApply = storeDiscounts.filter((discount) => discount.isActive && discount.products.some((p) => {
+                    if (typeof p === 'string') {
+                        return p === prod._id;
+                    }
+                    else if (typeof p === 'object') {
+                        return p._id === prod._id;
+                    }
+                    return false;
+                }));
+                const customerDiscount = (selectedCustomer === null || selectedCustomer === void 0 ? void 0 : selectedCustomer.discount) / 100 || 0;
+                const productPercentageDiscount = discountsToApply.reduce((prev, next) => {
+                    if (next.type === 'percentage') {
+                        return prev + next.value / 100;
+                    }
+                    return prev;
+                }, 0);
+                const prodPrice = isExpress ? prod.expressPrice : prod.price;
+                // Se remueve el extraAmountPerUnit para que el descuento se aplique solo sobre prodPrice
+                const discountAmount = +((productPercentageDiscount + customerDiscount) * prodPrice).toFixed(2);
+                return Object.assign(Object.assign({}, prod), { discountAmount: discountAmount });
+            }),
+            buyAndGetProds: []
+        };
+    }
+    // Reiniciar los descuentos en los productos
+    let newOrderProds = productsArr.map((prod) => (Object.assign(Object.assign({}, prod), { discountAmount: 0 })));
+    // Array para productos de descuento BUY_X_GET_Y o FREE_ITEM
+    const buyAndGetProds = [];
+    if (discountCode && discountCode.type === DiscountCodeTypes.PERCENTAGE) {
+        const percentageDiscount = discountCode.value / 100;
+        if (discountCode.applyToAllProducts) {
+            newOrderProds = newOrderProds.map((prod) => {
+                const prodPrice = isExpress ? prod.expressPrice : prod.price;
+                // Aplica descuento solo sobre prodPrice (no se incluye extraAmountPerUnit)
+                const discountAmount = +(percentageDiscount * prodPrice).toFixed(2);
+                return Object.assign(Object.assign({}, prod), { discountAmount: discountAmount });
+            });
+        }
+        else {
+            for (let discountProduct of discountCode.products) {
+                const prodIdx = newOrderProds.findIndex((prod) => prod._id === discountProduct);
+                if (prodIdx !== -1) {
+                    let prodObj = newOrderProds[prodIdx];
+                    const prodPrice = isExpress ? prodObj.expressPrice : prodObj.price;
+                    const discountAmount = +(percentageDiscount * prodPrice).toFixed(2);
+                    prodObj.discountAmount = discountAmount;
+                    newOrderProds[prodIdx] = prodObj;
+                }
+            }
+        }
+    }
+    if (discountCode && discountCode.type === DiscountCodeTypes.NUMBER) {
+        const discountAmount = discountCode.value;
+        if (!discountCode.applyOnceOnOrder) {
+            if (discountCode.applyToAllProducts) {
+                newOrderProds = newOrderProds.map((prod) => (Object.assign(Object.assign({}, prod), { discountAmount: discountAmount })));
+            }
+            else {
+                for (let discountProduct of discountCode.products) {
+                    const prodIdx = newOrderProds.findIndex((prod) => prod._id === discountProduct);
+                    if (prodIdx !== -1) {
+                        let prodObj = newOrderProds[prodIdx];
+                        prodObj.discountAmount = discountAmount;
+                        newOrderProds[prodIdx] = prodObj;
+                    }
+                }
+            }
+        }
+    }
+    if (discountCode.buyAndGetConditions && discountCode.type === DiscountCodeTypes.BUY_X_GET_Y) {
+        const buyConditions = discountCode.buyAndGetConditions[0].buyConditions;
+        const getConditions = discountCode.buyAndGetConditions[0].getConditions;
+        const discountType = discountCode.buyAndGetConditions[0].getDiscountType;
+        const discountValue = discountCode.buyAndGetConditions[0].discountValue;
+        let buyConditionFulfilledCounter = 0;
+        for (let prodCondition of buyConditions) {
+            const orderProd = productsArr.find((ordProd) => ordProd._id === prodCondition.buyProduct._id);
+            // Nota: Aquí solo se verifica una condición de producto
+            if (orderProd) {
+                let qty = orderProd.qty || orderProd.quantity;
+                buyConditionFulfilledCounter = Math.floor(qty / prodCondition.qty);
+            }
+        }
+        if (buyConditionFulfilledCounter) {
+            for (let prodCondition of getConditions) {
+                // Se utiliza solo el precio del producto (sin extraAmount) para calcular el descuento
+                const prodPrice = isExpress
+                    ? prodCondition.getProduct.expressPrice
+                    : prodCondition.getProduct.price;
+                const percentageDiscount = discountValue / 100;
+                const discountAmount = discountType === BuyAndGetConditionsTypes.FREE
+                    ? prodPrice
+                    : +(percentageDiscount * prodPrice).toFixed(2);
+                buyAndGetProds.push(Object.assign(Object.assign({}, prodCondition.getProduct), { qty: buyConditionFulfilledCounter * prodCondition.qty, quantity: buyConditionFulfilledCounter * prodCondition.qty, discountAmount: discountAmount, isBuyAndGetProduct: true }));
+            }
+        }
+    }
+    else if (discountCode.type === DiscountCodeTypes.FREE_ITEM) {
+        const freeProductsSettinggs = discountCode.freeProductSetting[0];
+        const freeProduct = freeProductsSettinggs.product;
+        const prodPrice = isExpress ? freeProduct.expressPrice : freeProduct.price;
+        // Para free item, se asume que el producto es gratuito, es decir, se descuenta el precio del producto
+        const discountAmount = prodPrice;
+        buyAndGetProds.push(Object.assign(Object.assign({}, freeProduct), { qty: freeProductsSettinggs.qty, quantity: freeProductsSettinggs.qty, discountAmount: discountAmount, isBuyAndGetProduct: true, isFreeItem: true }));
+    }
+    return { newOrderProds, buyAndGetProds };
+};

package/dist/utils/orders/index.js

@@ -1,5 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateOrderTotal = void 0;
-const calculateOrderTotal_1 = require("./calculateOrderTotal");
-Object.defineProperty(exports, "calculateOrderTotal", { enumerable: true, get: function () { return calculateOrderTotal_1.calculateOrderTotal; } });
+import { calculateOrderTotal } from './calculateOrderTotal';
+import { applyDiscountToProducts } from './helpers';
+export { calculateOrderTotal, applyDiscountToProducts };

package/dist/utils/receipt/generateReceiptHTML.js

@@ -0,0 +1,157 @@
+"use strict";
+// import moment from "moment";
+// import { formatMoneyString, truncateOrFill } from "../util";
+// export const generateReceiptThermalPrinter = (order, storeSettings, ticketStructure, charsPerLine = 32) => {
+//   //THIS STRING IS FORMED WITH THE EXPECTED USE OF react-native-thermal-receipt-printer PACKAGE
+//   const PAPER_LINE_LENGTH = charsPerLine;
+//   const orderProducts = order?.products || [];
+//   const orderBuyAndGerProducts = order?.buyAndGetProducts || [];
+//   const orderAllProducts = [...orderProducts, ...orderBuyAndGerProducts];
+//   console.log('PAPER_LINE_LENGTH', PAPER_LINE_LENGTH);
+//   const paymentLinesTotal =
+//     order.paymentLines?.reduce((prev, next) => {
+//       return prev + (next?.amountPaid || 0);
+//     }, 0) || 0;
+//   let headers = `
+//     ${ticketStructure.showStoreName ? `<CM>${storeSettings.name}</CM>` : ''}
+//     ${ticketStructure.showStorePhone ? `Tel: ${storeSettings.phone}` : ''}
+//     ${'-'.repeat(PAPER_LINE_LENGTH)}
+//     ${ticketStructure.showEmisionDate
+//       ? `Fecha emision: ${moment(order?.createdDate).format('DD/MM/YYYY')}`
+//       : ''
+//     }
+//     ${ticketStructure.showEmisionTime
+//       ? `Hora emision: ${moment(order?.createdDate).format('hh:mm a')}`
+//       : ''
+//     }
+//     ${ticketStructure.showCreatedByName ? `Atendio: ${order.createdBy.name}` : ''}
+//     Pedido: WD-${order.sequence}
+//     ${ticketStructure.showCustomerName ? `Cliente: ${order.customer.name}` : ''}
+//     ${ticketStructure.showDeliveryDate
+//       ? `Entrega: ${moment(order?.deliveryInfo?.date).format('DD/MM/YYYY')} ${ticketStructure.showDeliveryTime
+//         ? moment(order?.deliveryInfo?.fromTime).format('HH:mm')
+//         : ''
+//       }`
+//       : ''
+//     }
+//     ${ticketStructure.showTotalPieces ? `Piezas: ${orderAllProducts?.reduce((prev, curr) => {
+//       return prev + +curr.pieces * curr.quantity;
+//     }, 0)}` : ''}
+//     ${ticketStructure.showOrderNotes && order.notes ? `${order.notes}` : ''}
+//     `;
+//   let middle = '';
+//   //Add order products
+//   orderAllProducts.forEach(prod => {
+//     //CHARS PER LINE: 32 in 58MM PAPER
+//     const quantityFixed = truncateOrFill(
+//       `x${prod.quantity.toString()}`,
+//       3,
+//       'right',
+//     );
+//     const prodNameFixed = truncateOrFill(
+//       prod.name,
+//       PAPER_LINE_LENGTH - 3 - 7 - 7 - 3,
+//       'right',
+//     );
+//     const unitPriceFixed = truncateOrFill(
+//       formatMoneyString(
+//         (order?.express ? +prod.expressPrice : +prod.price) +
+//         (+prod.extraAmount / +prod.quantity || 0),
+//       ),
+//       7,
+//       'left',
+//     );
+//     const totalPriceFixed = truncateOrFill(
+//       formatMoneyString(
+//         (order?.express ? +prod.expressPrice : +prod.price) * +prod.quantity +
+//         (+prod.extraAmount || 0),
+//       ),
+//       7,
+//       'left',
+//     );
+//     middle =
+//       middle +
+//       `${quantityFixed} ${prodNameFixed} ${unitPriceFixed} ${totalPriceFixed}\n`;
+//   });
+//   let footer = '';
+//   footer =
+//     footer +
+//     `\n${truncateOrFill(
+//       'Subtotal: ' +
+//       formatMoneyString(order.productTotalWithoutDiscount || 0),
+//       PAPER_LINE_LENGTH,
+//       'left',
+//     )}`;
+//   if (ticketStructure.showDiscounts) {
+//     footer =
+//       footer +
+//       `\n${truncateOrFill(
+//         'Descuento: ' + formatMoneyString(order.totalDiscountAmount || 0),
+//         PAPER_LINE_LENGTH,
+//         'left',
+//       )}`;
+//   }
+//   if (ticketStructure.showCredit) {
+//     footer =
+//       footer +
+//       `\n${truncateOrFill(
+//         'Credito: ' + formatMoneyString(order.creditApplied || 0),
+//         PAPER_LINE_LENGTH,
+//         'left',
+//       )}`;
+//   }
+//   if (ticketStructure.showTaxes) {
+//     footer =
+//       footer +
+//       `\n${truncateOrFill(
+//         'Impuestos: ' + formatMoneyString(order.taxesTotal || 0),
+//         PAPER_LINE_LENGTH,
+//         'left',
+//       )}`;
+//   }
+//   footer =
+//     footer +
+//     `${order.delivery || order.pickup
+//       ? `\n${truncateOrFill(
+//         'Servicio a domicilio: ' +
+//         formatMoneyString(order.shippingServiceTotal || 0),
+//         PAPER_LINE_LENGTH,
+//         'left',
+//       )}`
+//       : ''
+//     }`;
+//   footer =
+//     footer +
+//     '\n' +
+//     `${truncateOrFill(
+//       'Total: ' + formatMoneyString(order.total || 0),
+//       PAPER_LINE_LENGTH,
+//       'left',
+//     )}`;
+//   footer =
+//     footer +
+//     '\n' +
+//     `${truncateOrFill(
+//       'Pago: ' + formatMoneyString(paymentLinesTotal),
+//       PAPER_LINE_LENGTH,
+//       'left',
+//     )}`;
+//   footer =
+//     footer +
+//     '\n' +
+//     `${truncateOrFill(
+//       'Debe: ' + ((order.total || 0) - paymentLinesTotal).toFixed(2),
+//       PAPER_LINE_LENGTH,
+//       'left',
+//     )}`;
+//   footer = footer + `\n${'-'.repeat(PAPER_LINE_LENGTH)}\n`;
+//   // footer = footer + `${ticketStructure.showPaymentMethod ? `<C>${translatePaymentType(order.paymentMethod)}</C>\n` : ''}`
+//   footer =
+//     footer +
+//     `${ticketStructure.showLegend
+//       ? `<C>${ticketStructure.ticketLegendText}</C>`
+//       : ''
+//     }`;
+//   const ticket = headers + '\n' + middle + '\n' + footer;
+//   return ticket;
+// }

package/dist/utils/util.js

@@ -0,0 +1,63 @@
+// export function truncateOrFill(str: string, n: number, side: string = 'right') {
+//     let needSpacesQty = n - str.length;
+//     let whiteSpace = '';
+//     if (needSpacesQty > 0) {
+//         for (let i = 0; i < needSpacesQty; i++) {
+//             whiteSpace += ' ';
+//         }
+//     }
+//     return str.length > n
+//         ? str.substr(0, n - 3) + '...'
+//         : side === 'right'
+//             ? str + whiteSpace
+//             : whiteSpace + str;
+// }
+// export const formatMoneyString = (
+//     amount: string | number = 0,
+//     decimalCount: number = 2,
+//     decimal = '.',
+//     thousands = ',',
+//     currencySymbol = '$',
+// ) => {
+//     try {
+//         decimalCount = Math.abs(decimalCount);
+//         decimalCount = isNaN(decimalCount) ? 2 : decimalCount;
+//         const negativeSign = amount < 0 ? '-' : '';
+//         let i = parseInt(
+//             (amount = Math.abs(Number(amount) || 0).toFixed(decimalCount)),
+//         ).toString();
+//         let j = i.length > 3 ? i.length % 3 : 0;
+//         return (
+//             currencySymbol +
+//             negativeSign +
+//             (j ? i.substr(0, j) + thousands : '') +
+//             i.substr(j).replace(/(\d{3})(?=\d)/g, '$1' + thousands) +
+//             (decimalCount
+//                 ? decimal +
+//                 Math.abs(amount - i)
+//                     .toFixed(decimalCount)
+//                     .slice(2)
+//                 : '')
+//         );
+//     } catch (e) {
+//         console.log(e);
+//     }
+// };
+// Function to get a formatted address
+export function getFormattedAddress(address) {
+    const { street, neighborhood, postalCode, city, state, country } = address;
+    let formatted = '';
+    if (street)
+        formatted += street;
+    if (neighborhood)
+        formatted += `, ${neighborhood}`;
+    if (city)
+        formatted += `, ${city}`;
+    if (state)
+        formatted += `, ${state}`;
+    if (postalCode)
+        formatted += `, ${postalCode}`;
+    if (country)
+        formatted += `, ${country}`;
+    return formatted.trim();
+}

package/docs/README.md

@@ -0,0 +1,67 @@
+# 📚 Washday SDK Documentation
+
+Welcome to the Washday SDK documentation! This folder contains comprehensive guides and API references for all modules.
+
+## 📖 Getting Started
+
+- [Installation and Setup](./getting-started.md)
+- [Authentication](./authentication.md)
+- [Error Handling](./error-handling.md)
+
+## 🔧 API Modules
+
+### Core Modules
+- [**Attendance**](./modules/attendance.md) - Employee time tracking and clock-in/out
+- [**Orders**](./modules/orders.md) - Order management and processing
+- [**Customers**](./modules/customers.md) - Customer data and management
+- [**Products**](./modules/products.md) - Product catalog and inventory
+
+### Store Management
+- [**Stores**](./modules/stores.md) - Store configuration and settings
+- [**Staff**](./modules/staff.md) - Staff management and permissions
+- [**Inventory**](./modules/inventory.md) - Stock management and tracking
+- [**Supplies**](./modules/supplies.md) - Supply management
+
+### Financial
+- [**Cash-ups**](./modules/cashups.md) - Cash register management
+- [**CFDI**](./modules/cfdi.md) - Mexican tax invoicing
+- [**Payments**](./modules/payments.md) - Payment processing
+
+### Reporting & Analytics
+- [**Reports**](./modules/reports.md) - Business analytics and reports
+- [**CSV Exports**](./modules/csv-exports.md) - Data export functionality
+- [**PDF Exports**](./modules/pdf-exports.md) - Document generation
+
+### Additional Services
+- [**Routes**](./modules/routes.md) - Delivery route management
+- [**Reviews**](./modules/reviews.md) - Customer feedback system
+- [**Partners**](./modules/partners.md) - Third-party integrations
+- [**Authentication**](./modules/auth.md) - User authentication flows
+
+## 📋 Examples
+
+- [**Common Use Cases**](./examples/common-use-cases.md)
+- [**Error Handling Examples**](./examples/error-handling.md)
+- [**TypeScript Integration**](./examples/typescript.md)
+
+## 🆕 What's New
+
+- **v1.1.1**: 🐛 Fixed missing parameters in attendance endpoints (`userId` in getHistory/getStatus, `storeId` in clockOut)
+- **v1.1.0**: Added Attendance module with clock-in/out functionality
+- **v1.0.2**: Enhanced order management features
+
+## 🤝 Contributing
+
+When adding new modules or updating existing ones:
+
+1. Create module documentation in `docs/modules/[module-name].md`
+2. Update this main README with the new module link
+3. Add practical examples in `docs/examples/`
+4. Update the version changelog
+
+## 📞 Support
+
+For questions or issues:
+- Check the module-specific documentation first
+- Review the examples section
+- Contact the development team