washday-sdk 1.6.39 → 1.6.41

package/.github/workflows/bump-version-pr.yml

@@ -20,10 +20,10 @@ jobs:
           ref: ${{ github.head_ref }}
           token: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Use Node.js 22
+      - name: Use Node.js 24
         uses: actions/setup-node@v4
         with:
-          node-version: 22
+          node-version: 24
 
       - name: Configure git identity
         run: |

package/.github/workflows/publish-on-merge.yml

@@ -17,13 +17,10 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: Use Node.js 22
+      - name: Use Node.js 24
         uses: actions/setup-node@v4
         with:
-          node-version: 22
-
-      - name: Update npm to latest
-        run: npm install -g npm@latest
+          node-version: 24
 
       - name: Install dependencies
         run: npm ci

package/dist/api/index.js

@@ -151,7 +151,8 @@ const WashdayClient = function WashdayClient(apiToken, env = 'PROD', clientId, c
         bulkCancel: ordersEndpoints.putModule.bulkCancel,
         bulkClean: ordersEndpoints.putModule.bulkClean,
         bulkCollect: ordersEndpoints.putModule.bulkCollect,
-        cancelOrderByIdCustomersApp: ordersEndpoints.deleteModule.cancelOrderByIdCustomersApp
+        cancelOrderByIdCustomersApp: ordersEndpoints.deleteModule.cancelOrderByIdCustomersApp,
+        updateLineStatuses: ordersEndpoints.patchModule.updateLineStatuses,
     });
     this.customers = bindMethods(this, {
         getCustomers: customersEndpoints.getModule.getList,
@@ -321,6 +322,7 @@ const WashdayClient = function WashdayClient(apiToken, env = 'PROD', clientId, c
         getDiscountCodesReport: reportsExportEndpoints.getModule.getDiscountCodesReport,
         getStaffReport: reportsExportEndpoints.getModule.getStaffReport,
         getProductSalesReport: reportsExportEndpoints.getModule.getProductSalesReport,
+        getProductSalesDrillDown: reportsExportEndpoints.getModule.getProductSalesDrillDown,
         getPaymentLinesReport: reportsExportEndpoints.getModule.getPaymentLinesReport,
         getCashierBoxMovementsReport: reportsExportEndpoints.getModule.getCashierBoxMovementsReport,
         getUnpaidOrdersReport: reportsExportEndpoints.getModule.getUnpaidOrdersReport,

package/dist/api/order/index.js

@@ -1,4 +1,5 @@
 export * as deleteModule from './delete';
 export * as getModule from './get';
+export * as patchModule from './patch';
 export * as postModule from './post';
 export * as putModule from './put';

package/dist/api/order/patch.js

@@ -0,0 +1,28 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+const ORDER_LINE_STATUSES = (orderId) => `/api/v2/order/${orderId}/line-statuses`;
+/**
+ * Batch update of line-level statuses for a single order.
+ *
+ * - Validates all transitions server-side before applying any.
+ * - Does NOT modify the order's own status.
+ * - Returns the full updated order.
+ *
+ * Actor: Staff / POS (requires valid auth token)
+ * Endpoint: PATCH /api/v2/order/:id/line-statuses
+ */
+export const updateLineStatuses = function (orderId, dto) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const config = {
+            headers: { Authorization: `Bearer ${this.apiToken}` },
+        };
+        return yield this.axiosInstance.patch(ORDER_LINE_STATUSES(orderId), dto, config);
+    });
+};

package/dist/api/reports/get.js

@@ -164,6 +164,26 @@ export const getProductSalesReport = function (storeId, params) {
         }
     });
 };
+export const getProductSalesDrillDown = function (storeId, params) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const config = {
+                headers: { Authorization: `Bearer ${this.apiToken}` }
+            };
+            const queryParams = generateQueryParamsStr([
+                'storeProductId',
+                'fromDate',
+                'toDate',
+                'timezone',
+            ], params);
+            return yield this.axiosInstance.get(`${GET_SET_REPORTS}/${storeId}/productSales/drill-down?${queryParams}`, config);
+        }
+        catch (error) {
+            console.error('Error fetching getProductSalesDrillDown:', error);
+            throw error;
+        }
+    });
+};
 export const getPaymentLinesReport = function (storeId, params) {
     return __awaiter(this, void 0, void 0, function* () {
         try {

package/dist/enum/index.js

@@ -18,3 +18,12 @@ export var PaymentMethodsEnum;
     PaymentMethodsEnum["Delivery"] = "delivery";
     PaymentMethodsEnum["Transfer"] = "transfer";
 })(PaymentMethodsEnum || (PaymentMethodsEnum = {}));
+export var OrderProductLineStatus;
+(function (OrderProductLineStatus) {
+    OrderProductLineStatus["Created"] = "created";
+    OrderProductLineStatus["Cleaning"] = "cleaning";
+    OrderProductLineStatus["Ready"] = "ready";
+    OrderProductLineStatus["Collected"] = "collected";
+    OrderProductLineStatus["Uncollected"] = "uncollected";
+    OrderProductLineStatus["Cancelled"] = "cancelled";
+})(OrderProductLineStatus || (OrderProductLineStatus = {}));

package/dist/interfaces/Store.ticketStructurePresets.test.js

@@ -0,0 +1,60 @@
+const folioPreset = "large";
+const spacingPreset = "medium";
+const ticketStructure = {
+    showTotalPieces: false,
+    showEmisionDate: true,
+    showEmisionTime: true,
+    showLegend: true,
+    showPaymentMethod: true,
+    showStorePhone: true,
+    showCustomerPoints: false,
+    showDeliveryDate: true,
+    showDeliveryTime: true,
+    ticketLegendText: "Gracias",
+    showStoreName: true,
+    showCustomerName: true,
+    showCreatedByName: true,
+    showOrderNotes: false,
+    showTaxes: false,
+    showDiscounts: true,
+    showCredit: true,
+    customerNameFontSize: "small",
+    orderFolioFontSizePreset: folioPreset,
+    ticketLineSpacingPreset: spacingPreset,
+    ticketPrintFormat: "escpos",
+};
+const labelTicketStructure = Object.assign({}, ticketStructure);
+const ticketForLaundryStructure = {
+    showTotalPieces: false,
+    showEmisionDate: true,
+    showEmisionTime: true,
+    showLegend: true,
+    showPaymentMethod: true,
+    showStorePhone: true,
+    showCustomerPoints: false,
+    showDeliveryDate: true,
+    showDeliveryTime: true,
+    ticketLegendText: "Gracias",
+    printLogoOnTicket: false,
+    showStoreName: true,
+    showCustomerName: true,
+    showCreatedByName: true,
+    showOrderNotes: false,
+    showTaxes: false,
+    showDiscounts: true,
+    showCredit: true,
+    customerNameFontSize: "medium",
+    orderFolioFontSizePreset: "large",
+    ticketLineSpacingPreset: "small",
+    ticketPrintFormat: "html",
+};
+if (ticketStructure.orderFolioFontSizePreset !== "large") {
+    throw new Error("Ticket structure folio preset was not preserved");
+}
+if (labelTicketStructure.ticketLineSpacingPreset !== "medium") {
+    throw new Error("Label ticket structure spacing preset was not preserved");
+}
+if (ticketForLaundryStructure.customerNameFontSize !== "medium") {
+    throw new Error("Laundry ticket structure customer font size was not preserved");
+}
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "washday-sdk",
-  "version": "1.6.39",
+  "version": "1.6.41",
   "description": "Washday utilities functions and API",
   "main": "dist/index.js",
   "type": "module",

package/src/api/index.ts

@@ -158,7 +158,8 @@ const WashdayClient: WashdayClientConstructor = function WashdayClient(this: Was
         bulkCancel: ordersEndpoints.putModule.bulkCancel,
         bulkClean: ordersEndpoints.putModule.bulkClean,
         bulkCollect: ordersEndpoints.putModule.bulkCollect,
-        cancelOrderByIdCustomersApp: ordersEndpoints.deleteModule.cancelOrderByIdCustomersApp
+        cancelOrderByIdCustomersApp: ordersEndpoints.deleteModule.cancelOrderByIdCustomersApp,
+        updateLineStatuses: ordersEndpoints.patchModule.updateLineStatuses,
     });
     this.customers = bindMethods(this, {
         getCustomers: customersEndpoints.getModule.getList,
@@ -328,6 +329,7 @@ const WashdayClient: WashdayClientConstructor = function WashdayClient(this: Was
         getDiscountCodesReport: reportsExportEndpoints.getModule.getDiscountCodesReport,
         getStaffReport: reportsExportEndpoints.getModule.getStaffReport,
         getProductSalesReport: reportsExportEndpoints.getModule.getProductSalesReport,
+        getProductSalesDrillDown: reportsExportEndpoints.getModule.getProductSalesDrillDown,
         getPaymentLinesReport: reportsExportEndpoints.getModule.getPaymentLinesReport,
         getCashierBoxMovementsReport: reportsExportEndpoints.getModule.getCashierBoxMovementsReport,
         getUnpaidOrdersReport: reportsExportEndpoints.getModule.getUnpaidOrdersReport,

package/src/api/order/index.ts

@@ -1,4 +1,5 @@
 export * as deleteModule from './delete';
 export * as getModule from './get';
+export * as patchModule from './patch';
 export * as postModule from './post';
 export * as putModule from './put';

package/src/api/order/patch.ts

@@ -0,0 +1,25 @@
+import { WashdayClientInstance } from '../../interfaces/Api';
+import { IUpdateOrderLineStatusesDto } from '../../interfaces/Order';
+
+const ORDER_LINE_STATUSES = (orderId: string) => `/api/v2/order/${orderId}/line-statuses`;
+
+/**
+ * Batch update of line-level statuses for a single order.
+ *
+ * - Validates all transitions server-side before applying any.
+ * - Does NOT modify the order's own status.
+ * - Returns the full updated order.
+ *
+ * Actor: Staff / POS (requires valid auth token)
+ * Endpoint: PATCH /api/v2/order/:id/line-statuses
+ */
+export const updateLineStatuses = async function (
+    this: WashdayClientInstance,
+    orderId: string,
+    dto: IUpdateOrderLineStatusesDto
+): Promise<any> {
+    const config = {
+        headers: { Authorization: `Bearer ${this.apiToken}` },
+    };
+    return await this.axiosInstance.patch(ORDER_LINE_STATUSES(orderId), dto, config);
+};

package/src/api/reports/get.ts

@@ -175,6 +175,29 @@ export const getProductSalesReport = async function (this: WashdayClientInstance
     }
 };
 
+export const getProductSalesDrillDown = async function (this: WashdayClientInstance, storeId: string, params: {
+    storeProductId: string
+    fromDate?: string
+    toDate?: string
+    timezone?: string
+}): Promise<any> {
+    try {
+        const config = {
+            headers: { Authorization: `Bearer ${this.apiToken}` }
+        };
+        const queryParams = generateQueryParamsStr([
+            'storeProductId',
+            'fromDate',
+            'toDate',
+            'timezone',
+        ], params);
+        return await this.axiosInstance.get(`${GET_SET_REPORTS}/${storeId}/productSales/drill-down?${queryParams}`, config);
+    } catch (error) {
+        console.error('Error fetching getProductSalesDrillDown:', error);
+        throw error;
+    }
+};
+
 export const getPaymentLinesReport = async function (this: WashdayClientInstance, storeId: string, params: {
     fromDate?: string
     toDate?: string

package/src/enum/index.ts

@@ -16,4 +16,13 @@ export enum PaymentMethodsEnum {
     Card = "card",
     Delivery = "delivery",
     Transfer = "transfer",
+}
+
+export enum OrderProductLineStatus {
+    Created     = 'created',
+    Cleaning    = 'cleaning',
+    Ready       = 'ready',
+    Collected   = 'collected',
+    Uncollected = 'uncollected',
+    Cancelled   = 'cancelled',
 }

package/src/interfaces/Api.ts

@@ -144,6 +144,7 @@ export interface WashdayClientInstance {
         bulkClean: typeof ordersEndpoints.putModule.bulkClean,
         bulkCollect: typeof ordersEndpoints.putModule.bulkCollect,
         cancelOrderByIdCustomersApp: typeof ordersEndpoints.deleteModule.cancelOrderByIdCustomersApp;
+        updateLineStatuses: typeof ordersEndpoints.patchModule.updateLineStatuses;
     };
     customers: {
         getCustomers: typeof customersEndpoints.getModule.getList;
@@ -313,6 +314,7 @@ export interface WashdayClientInstance {
         getDiscountCodesReport: typeof reportsExportEndpoints.getModule.getDiscountCodesReport;
         getStaffReport: typeof reportsExportEndpoints.getModule.getStaffReport;
         getProductSalesReport: typeof reportsExportEndpoints.getModule.getProductSalesReport;
+        getProductSalesDrillDown: typeof reportsExportEndpoints.getModule.getProductSalesDrillDown;
         getPaymentLinesReport: typeof reportsExportEndpoints.getModule.getPaymentLinesReport;
         getCashierBoxMovementsReport: typeof reportsExportEndpoints.getModule.getCashierBoxMovementsReport;
         getUnpaidOrdersReport: typeof reportsExportEndpoints.getModule.getUnpaidOrdersReport;

package/src/interfaces/Order.ts

@@ -2,6 +2,7 @@ import { ICustomer } from "./Customer";
 import { IOrderProduct, IProduct } from "./Product";
 import { ICashierBox, IStore, IStoreDiscount, ITaxConfig } from "./Store";
 import { IUser } from "./User";
+import { OrderProductLineStatus } from "../enum";
 
 interface IDeliveryInfo {
     date: Date,
@@ -102,6 +103,22 @@ export interface IOrder {
 }
 
 
+/**
+ * A single line status update within a batch request.
+ * `status` cannot be 'created' — lines cannot be reset to initial state.
+ */
+export interface IOrderLineStatusUpdate {
+    lineId: string;
+    status: Exclude<OrderProductLineStatus, OrderProductLineStatus.Created>;
+}
+
+/**
+ * Request body for PATCH /api/v2/order/:id/line-statuses
+ */
+export interface IUpdateOrderLineStatusesDto {
+    updates: IOrderLineStatusUpdate[];
+}
+
 export interface IOrderInfo {
     topProducts: IProduct[];
     sales: number;

package/src/interfaces/Product.ts

@@ -1,6 +1,7 @@
 import { IStore } from "./Store"
 import { IStoreImage } from "./StoreImage"
 import { IUser } from "./User"
+import { OrderProductLineStatus } from "../enum"
 
 export interface ProductLineTotals {
     product: IOrderProduct,
@@ -71,4 +72,17 @@ export interface IOrderProduct extends IProduct {
     isBuyAndGetProduct: boolean,
     storeProductId: IStoreProduct | string
     qty?: number
+
+    // Operational line-level status fields (added 2026-04-04)
+    status?: OrderProductLineStatus,
+    cleanedDateTime?: Date | null,
+    readyDateTime?: Date | null,
+    collectedDateTime?: Date | null,
+    uncollectedDateTime?: Date | null,
+    cancelledDateTime?: Date | null,
+    markedCleanedBy?: IUser | string | null,
+    markedReadyBy?: IUser | string | null,
+    markedCollectedBy?: IUser | string | null,
+    markedUncollectedBy?: IUser | string | null,
+    markedCancelledBy?: IUser | string | null,
 }

package/src/interfaces/Store.ticketStructurePresets.test.ts

@@ -0,0 +1,74 @@
+import {
+  ILabelTicketStructure,
+  ITicketForLaundryStructure,
+  ITicketStructure,
+  TicketVisualPreset,
+} from "./Store";
+
+const folioPreset: TicketVisualPreset = "large";
+const spacingPreset: TicketVisualPreset = "medium";
+
+const ticketStructure: ITicketStructure = {
+  showTotalPieces: false,
+  showEmisionDate: true,
+  showEmisionTime: true,
+  showLegend: true,
+  showPaymentMethod: true,
+  showStorePhone: true,
+  showCustomerPoints: false,
+  showDeliveryDate: true,
+  showDeliveryTime: true,
+  ticketLegendText: "Gracias",
+  showStoreName: true,
+  showCustomerName: true,
+  showCreatedByName: true,
+  showOrderNotes: false,
+  showTaxes: false,
+  showDiscounts: true,
+  showCredit: true,
+  customerNameFontSize: "small",
+  orderFolioFontSizePreset: folioPreset,
+  ticketLineSpacingPreset: spacingPreset,
+  ticketPrintFormat: "escpos",
+};
+
+const labelTicketStructure: ILabelTicketStructure = {
+  ...ticketStructure,
+};
+
+const ticketForLaundryStructure: ITicketForLaundryStructure = {
+  showTotalPieces: false,
+  showEmisionDate: true,
+  showEmisionTime: true,
+  showLegend: true,
+  showPaymentMethod: true,
+  showStorePhone: true,
+  showCustomerPoints: false,
+  showDeliveryDate: true,
+  showDeliveryTime: true,
+  ticketLegendText: "Gracias",
+  printLogoOnTicket: false,
+  showStoreName: true,
+  showCustomerName: true,
+  showCreatedByName: true,
+  showOrderNotes: false,
+  showTaxes: false,
+  showDiscounts: true,
+  showCredit: true,
+  customerNameFontSize: "medium",
+  orderFolioFontSizePreset: "large",
+  ticketLineSpacingPreset: "small",
+  ticketPrintFormat: "html",
+};
+
+if (ticketStructure.orderFolioFontSizePreset !== "large") {
+  throw new Error("Ticket structure folio preset was not preserved");
+}
+
+if (labelTicketStructure.ticketLineSpacingPreset !== "medium") {
+  throw new Error("Label ticket structure spacing preset was not preserved");
+}
+
+if (ticketForLaundryStructure.customerNameFontSize !== "medium") {
+  throw new Error("Laundry ticket structure customer font size was not preserved");
+}

package/src/interfaces/Store.ts

@@ -291,6 +291,7 @@ export interface IOrderPageConfig {
 }
 
 export type TicketPrintFormat = 'html' | 'escpos';
+export type TicketVisualPreset = 'small' | 'medium' | 'large';
 
 export interface ITicketStructure {
     showTotalPieces: Boolean,
@@ -310,6 +311,9 @@ export interface ITicketStructure {
     showTaxes: Boolean,
     showDiscounts: Boolean,
     showCredit: Boolean,
+    customerNameFontSize?: TicketVisualPreset,
+    orderFolioFontSizePreset?: TicketVisualPreset,
+    ticketLineSpacingPreset?: TicketVisualPreset,
     ticketPrintFormat?: TicketPrintFormat,
 }
 
@@ -333,6 +337,9 @@ export interface ITicketForLaundryStructure {
     showTaxes: Boolean,
     showDiscounts: Boolean,
     showCredit: Boolean,
+    customerNameFontSize?: TicketVisualPreset,
+    orderFolioFontSizePreset?: TicketVisualPreset,
+    ticketLineSpacingPreset?: TicketVisualPreset,
     ticketPrintFormat?: TicketPrintFormat,
 }