washday-sdk 1.6.66 → 1.6.67

package/dist/enum/index.js

@@ -18,6 +18,21 @@ export var PaymentMethodsEnum;
     PaymentMethodsEnum["Delivery"] = "delivery";
     PaymentMethodsEnum["Transfer"] = "transfer";
 })(PaymentMethodsEnum || (PaymentMethodsEnum = {}));
+export var OrderStatusEnum;
+(function (OrderStatusEnum) {
+    OrderStatusEnum["CREATED"] = "created";
+    OrderStatusEnum["REQUESTED"] = "requested";
+    OrderStatusEnum["PICKUP"] = "pickup";
+    OrderStatusEnum["PICKINGUP"] = "pickingup";
+    OrderStatusEnum["PENDING_STORE_RECEPTION_VALIDATION"] = "pending_store_reception_validation";
+    OrderStatusEnum["CLEANING"] = "cleaning";
+    OrderStatusEnum["READY"] = "ready";
+    OrderStatusEnum["DELIVERY"] = "delivery";
+    OrderStatusEnum["DELIVERING"] = "delivering";
+    OrderStatusEnum["COLLECTED"] = "collected";
+    OrderStatusEnum["CANCELLED"] = "cancelled";
+    OrderStatusEnum["UNCOLLECTED"] = "uncollected";
+})(OrderStatusEnum || (OrderStatusEnum = {}));
 export var OrderProductLineStatus;
 (function (OrderProductLineStatus) {
     OrderProductLineStatus["Created"] = "created";

package/dist/index.js

@@ -8,4 +8,9 @@ export * from './interfaces/Customer';
 export * from './interfaces/DomainUrls';
 export * from './interfaces/GoogleMaps';
 export * from './interfaces/Attendance';
+export * from './interfaces/Order';
+export * from './interfaces/Store';
+export * from './interfaces/Permission';
+export * from './interfaces/Route';
+export * from './enum';
 export { WashdayClient, utils };

package/dist/interfaces/StoreReceptionValidation.contract.test.js

@@ -0,0 +1,62 @@
+var _a, _b, _c;
+import { OrderStatusEnum } from "../index";
+const updatePayload = {
+    notes: "Peso confirmado en sucursal",
+    updateMode: "store_reception_validation",
+};
+const order = {
+    status: OrderStatusEnum.PENDING_STORE_RECEPTION_VALIDATION,
+    storeReceptionValidation: {
+        validatedAt: "2026-06-01T18:00:00.000Z",
+        validatedBy: "user-1",
+        source: "store_reception",
+        notes: "Validado en mostrador",
+    },
+};
+const permission = {
+    validateStoreReception: {
+        canMutate: true,
+    },
+};
+const store = {
+    storeReceptionValidationConfig: {
+        enabled: true,
+        restrictCloseRouteUntilStoreValidation: false,
+    },
+};
+const preview = {
+    routeId: "route-1",
+    canClose: true,
+    summary: {
+        confirmed: 0,
+        failed: 0,
+        cancelled: 0,
+        pendingActive: 0,
+    },
+    pendingActiveOrders: [],
+    requiresExplicitConfirmation: false,
+    hasPendingStoreReceptionValidations: true,
+    pendingStoreReceptionValidationOrdersCount: 1,
+    restrictCloseRouteUntilStoreValidation: false,
+    warnings: [
+        "Esta ruta tiene pedidos pendientes de validar en sucursal.",
+    ],
+};
+if (OrderStatusEnum.PENDING_STORE_RECEPTION_VALIDATION !== "pending_store_reception_validation") {
+    throw new Error("Pending store reception validation order status is not exported");
+}
+if (updatePayload.updateMode !== "store_reception_validation") {
+    throw new Error("Store reception validation update mode is not accepted");
+}
+if (((_a = order.storeReceptionValidation) === null || _a === void 0 ? void 0 : _a.source) !== "store_reception") {
+    throw new Error("Order store reception validation source was not preserved");
+}
+if (((_b = permission.validateStoreReception) === null || _b === void 0 ? void 0 : _b.canMutate) !== true) {
+    throw new Error("Validate store reception permission was not preserved");
+}
+if (((_c = store.storeReceptionValidationConfig) === null || _c === void 0 ? void 0 : _c.enabled) !== true) {
+    throw new Error("Store reception validation config was not preserved");
+}
+if (preview.pendingStoreReceptionValidationOrdersCount !== 1) {
+    throw new Error("Route close preview pending validation count was not preserved");
+}

package/package.json

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

package/src/api/order/put.ts

@@ -1,34 +1,13 @@
 import { AxiosResponse } from "axios";
 import { WashdayClientInstance } from "../../interfaces/Api";
+import { IUpdateOrderByIdDto } from "../../interfaces/Order";
 import axiosInstance from "../axiosInstance";
 import { generateQueryParamsStr } from "../../utils/apiUtils";
 const GET_SET_ORDER = 'api/v2/order';
 const GET_SET_ORDER_OLD = 'api/order';
 const GET_SET_ORDER_PAYMENTLINES = (orderId: string) => `/api/v2/order/${orderId}/paymentLines`;
 
-export const updateById = async function (this: WashdayClientInstance, id: string, data: {
-    status?: string,
-    products?: any[],
-    buyAndGetProducts?: any[],
-    customer?: string,
-    discountCode?: string | null,
-    notes?: string,
-    privateNotes?: string,
-    delivery?: boolean,
-    pickup?: boolean,
-    express?: boolean,
-    deliveryInfo?: {
-        date: Date,
-        fromTime: string,
-        toTime?: string
-    },
-    pickupInfo?: {
-        date: Date,
-        fromTime: string,
-        toTime?: string
-    },
-    notifyBy?: string,
-}): Promise<any> {
+export const updateById = async function (this: WashdayClientInstance, id: string, data: IUpdateOrderByIdDto): Promise<any> {
     try {
         const config = {
             headers: { Authorization: `Bearer ${this.apiToken}` }
@@ -221,4 +200,4 @@ export const bulkCollect = async function (this: WashdayClientInstance, storeId:
         console.error('Error fetching bulkCollect:', error);
         throw error;
     }
-};
+};

package/src/enum/index.ts

@@ -18,6 +18,21 @@ export enum PaymentMethodsEnum {
     Transfer = "transfer",
 }
 
+export enum OrderStatusEnum {
+    CREATED = 'created',
+    REQUESTED = 'requested',
+    PICKUP = 'pickup',
+    PICKINGUP = 'pickingup',
+    PENDING_STORE_RECEPTION_VALIDATION = 'pending_store_reception_validation',
+    CLEANING = 'cleaning',
+    READY = 'ready',
+    DELIVERY = 'delivery',
+    DELIVERING = 'delivering',
+    COLLECTED = 'collected',
+    CANCELLED = 'cancelled',
+    UNCOLLECTED = 'uncollected',
+}
+
 export enum OrderProductLineStatus {
     Created     = 'created',
     Cleaning    = 'cleaning',
@@ -25,4 +40,4 @@ export enum OrderProductLineStatus {
     Collected   = 'collected',
     Uncollected = 'uncollected',
     Cancelled   = 'cancelled',
-}
+}

package/src/index.ts

@@ -8,13 +8,11 @@ export * from './interfaces/Customer';
 export * from './interfaces/DomainUrls';
 export * from './interfaces/GoogleMaps';
 export * from './interfaces/Attendance';
-export type {
-  IOrderPricingSnapshot,
-  IOrderPricingSnapshotLine,
-  IOrderPricingSnapshotTotals,
-  ITaxBreakdownItem,
-  TaxBreakdownKey,
-} from './interfaces/Order';
+export * from './interfaces/Order';
+export * from './interfaces/Store';
+export * from './interfaces/Permission';
+export * from './interfaces/Route';
+export * from './enum';
 export type { StartMPOAuthFlowRequest } from './api/integrations/post';
 export type {
   CreateCFDISubscriptionCheckoutSessionRequest,

package/src/interfaces/Order.ts

@@ -2,7 +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";
+import { OrderProductLineStatus, OrderStatusEnum } from "../enum";
 import { RouteOrderCompletionSource } from "./Route";
 
 interface IDeliveryInfo {
@@ -34,6 +34,20 @@ export interface IFailedServiceAttemptPayload {
     images?: string[];
 }
 
+export type OrderStatus = OrderStatusEnum | (string & {});
+
+export type StoreReceptionValidationSource =
+    | "store_reception"
+    | "route_pickup_handoff"
+    | "legacy_unknown";
+
+export interface IOrderStoreReceptionValidation {
+    validatedAt?: string | Date | null;
+    validatedBy?: string | null;
+    source?: StoreReceptionValidationSource | null;
+    notes?: string;
+}
+
 export interface IOrderPaymentLines {
     _id?: any,
     amountPaid: number,
@@ -161,11 +175,12 @@ export interface IOrder {
     paidDateTime: Date | null,
     paymentMethod: string | null
     prepaidPaymentMethod: string | null
-    status: string,
+    status: OrderStatus,
     pickupRoute: string | null,
     deliveryRoute: string | null,
     pickupCompletion?: IOrderPhaseCompletion | null,
     deliveryCompletion?: IOrderPhaseCompletion | null,
+    storeReceptionValidation?: IOrderStoreReceptionValidation,
     sequence?: string | null,
     notifyBy: string,
     stripePaymentIntentId?: string | null,
@@ -180,6 +195,33 @@ export interface IOrder {
     pricingSnapshot?: IOrderPricingSnapshot | null,
 }
 
+export type OrderUpdateMode = "store_reception_validation";
+
+export interface IUpdateOrderByIdDto {
+    status?: OrderStatus,
+    products?: any[],
+    buyAndGetProducts?: any[],
+    customer?: string,
+    discountCode?: string | null,
+    notes?: string,
+    privateNotes?: string,
+    delivery?: boolean,
+    pickup?: boolean,
+    express?: boolean,
+    deliveryInfo?: {
+        date: Date,
+        fromTime: string,
+        toTime?: string
+    },
+    pickupInfo?: {
+        date: Date,
+        fromTime: string,
+        toTime?: string
+    },
+    notifyBy?: string,
+    updateMode?: OrderUpdateMode,
+}
+
 
 /**
  * A single line status update within a batch request.
@@ -230,7 +272,7 @@ export interface OrderDto {
     collectedDateTime: Date | null,
     cancelledDateTime: Date | null,
     paidDateTime: Date | null,
-    status: string,
+    status: OrderStatus,
     store: string,
     paymentMethod: string | null,
     prepaidAmount: number | null,

package/src/interfaces/Permission.ts

@@ -15,6 +15,7 @@ export interface IPermission {
     canEditOrders: IPermissionMutationType,
     canManageAttendance: IPermissionMutationType,
     mutateOrderPayments: IPermissionMutationType,
+    validateStoreReception?: IPermissionMutationType,
     markOrderAsCollectedWithPendingAmount: IPermissionMutationType,
     markOrderAsUncollected: IPermissionMutationType,
     cancelOrders: IPermissionMutationType,

package/src/interfaces/Route.ts

@@ -1,6 +1,6 @@
-import { IOrder } from "./Order";
-import { IStore } from "./Store";
-import { IUser } from "./User";
+import type { IOrder, OrderStatus } from "./Order";
+import type { IStore } from "./Store";
+import type { IUser } from "./User";
 
 export type RouteStatus = "created" | "in_progress" | "finished" | "cancelled";
 export type RouteOrderType = "pickup" | "delivery" | "legacy_unknown";
@@ -54,8 +54,8 @@ export interface IRouteClosePreviewPendingOrder {
   orderId: string;
   type: RouteOrderType;
   sequence?: string | number | null;
-  status?: string | null;
-  willBecome?: string | null;
+  status?: OrderStatus | null;
+  willBecome?: OrderStatus | null;
 }
 
 export interface IRouteClosePreview {
@@ -69,4 +69,8 @@ export interface IRouteClosePreview {
   };
   pendingActiveOrders: IRouteClosePreviewPendingOrder[];
   requiresExplicitConfirmation: boolean;
+  hasPendingStoreReceptionValidations?: boolean;
+  pendingStoreReceptionValidationOrdersCount?: number;
+  restrictCloseRouteUntilStoreValidation?: boolean;
+  warnings?: string[];
 }

package/src/interfaces/Store.ts

@@ -52,6 +52,11 @@ export interface IPublicReceiptConfig {
     showEvidence?: boolean
 }
 
+export interface IStoreReceptionValidationConfig {
+    enabled: boolean,
+    restrictCloseRouteUntilStoreValidation: boolean,
+}
+
 export interface IStore {
     name: string,
     streetAddress?: string,
@@ -90,6 +95,7 @@ export interface IStore {
     ticketForLaundryStructure?: ITicketForLaundryStructure | null,
     labelTicketStructure?: ILabelTicketStructure | null,
     publicReceiptConfig?: IPublicReceiptConfig,
+    storeReceptionValidationConfig?: IStoreReceptionValidationConfig,
     ticketScanMode?: 'order' | 'customer',
     storeDiscounts: IStoreDiscount | null,
     discountCodes: IDiscountCode | null,

package/src/interfaces/StoreReceptionValidation.contract.test.ts

@@ -0,0 +1,79 @@
+import { OrderStatusEnum } from "../index";
+import type {
+  IOrder,
+  IPermission,
+  IRouteClosePreview,
+  IStore,
+  IUpdateOrderByIdDto,
+} from "../index";
+
+const updatePayload: IUpdateOrderByIdDto = {
+  notes: "Peso confirmado en sucursal",
+  updateMode: "store_reception_validation",
+};
+
+const order: Partial<IOrder> = {
+  status: OrderStatusEnum.PENDING_STORE_RECEPTION_VALIDATION,
+  storeReceptionValidation: {
+    validatedAt: "2026-06-01T18:00:00.000Z",
+    validatedBy: "user-1",
+    source: "store_reception",
+    notes: "Validado en mostrador",
+  },
+};
+
+const permission: Partial<IPermission> = {
+  validateStoreReception: {
+    canMutate: true,
+  },
+};
+
+const store: Partial<IStore> = {
+  storeReceptionValidationConfig: {
+    enabled: true,
+    restrictCloseRouteUntilStoreValidation: false,
+  },
+};
+
+const preview: IRouteClosePreview = {
+  routeId: "route-1",
+  canClose: true,
+  summary: {
+    confirmed: 0,
+    failed: 0,
+    cancelled: 0,
+    pendingActive: 0,
+  },
+  pendingActiveOrders: [],
+  requiresExplicitConfirmation: false,
+  hasPendingStoreReceptionValidations: true,
+  pendingStoreReceptionValidationOrdersCount: 1,
+  restrictCloseRouteUntilStoreValidation: false,
+  warnings: [
+    "Esta ruta tiene pedidos pendientes de validar en sucursal.",
+  ],
+};
+
+if (OrderStatusEnum.PENDING_STORE_RECEPTION_VALIDATION !== "pending_store_reception_validation") {
+  throw new Error("Pending store reception validation order status is not exported");
+}
+
+if (updatePayload.updateMode !== "store_reception_validation") {
+  throw new Error("Store reception validation update mode is not accepted");
+}
+
+if (order.storeReceptionValidation?.source !== "store_reception") {
+  throw new Error("Order store reception validation source was not preserved");
+}
+
+if (permission.validateStoreReception?.canMutate !== true) {
+  throw new Error("Validate store reception permission was not preserved");
+}
+
+if (store.storeReceptionValidationConfig?.enabled !== true) {
+  throw new Error("Store reception validation config was not preserved");
+}
+
+if (preview.pendingStoreReceptionValidationOrdersCount !== 1) {
+  throw new Error("Route close preview pending validation count was not preserved");
+}

package/test/storeReceptionValidation.contract.test.ts

@@ -0,0 +1,89 @@
+import { updateById } from "../src/api/order/put";
+import { OrderStatusEnum } from "../src";
+import type {
+  IOrder,
+  IPermission,
+  IRouteClosePreview,
+  IStore,
+  IUpdateOrderByIdDto,
+} from "../src";
+
+describe("store reception validation SDK contract", () => {
+  it("exposes store reception validation contracts from the root package", () => {
+    const updatePayload: IUpdateOrderByIdDto = {
+      notes: "Peso confirmado en sucursal",
+      updateMode: "store_reception_validation",
+    };
+    const order: Partial<IOrder> = {
+      status: OrderStatusEnum.PENDING_STORE_RECEPTION_VALIDATION,
+      storeReceptionValidation: {
+        validatedAt: "2026-06-01T18:00:00.000Z",
+        validatedBy: "user-1",
+        source: "store_reception",
+        notes: "Validado en mostrador",
+      },
+    };
+    const permission: Partial<IPermission> = {
+      validateStoreReception: {
+        canMutate: true,
+      },
+    };
+    const store: Partial<IStore> = {
+      storeReceptionValidationConfig: {
+        enabled: true,
+        restrictCloseRouteUntilStoreValidation: false,
+      },
+    };
+    const preview: IRouteClosePreview = {
+      routeId: "route-1",
+      canClose: true,
+      summary: {
+        confirmed: 0,
+        failed: 0,
+        cancelled: 0,
+        pendingActive: 0,
+      },
+      pendingActiveOrders: [],
+      requiresExplicitConfirmation: false,
+      hasPendingStoreReceptionValidations: true,
+      pendingStoreReceptionValidationOrdersCount: 1,
+      restrictCloseRouteUntilStoreValidation: false,
+      warnings: [
+        "Esta ruta tiene pedidos pendientes de validar en sucursal.",
+      ],
+    };
+
+    expect(OrderStatusEnum.PENDING_STORE_RECEPTION_VALIDATION).toBe(
+      "pending_store_reception_validation"
+    );
+    expect(updatePayload.updateMode).toBe("store_reception_validation");
+    expect(order.storeReceptionValidation?.source).toBe("store_reception");
+    expect(permission.validateStoreReception?.canMutate).toBe(true);
+    expect(store.storeReceptionValidationConfig?.enabled).toBe(true);
+    expect(preview.pendingStoreReceptionValidationOrdersCount).toBe(1);
+  });
+
+  it("passes store reception validation update mode through updateById unchanged", async () => {
+    const put = jest.fn().mockResolvedValue({
+      data: {
+        data: {
+          _id: "order-1",
+        },
+      },
+    });
+    const client = {
+      apiToken: "token-123",
+      axiosInstance: { put },
+    } as any;
+    const payload: IUpdateOrderByIdDto = {
+      notes: "Peso ajustado",
+      updateMode: "store_reception_validation",
+    };
+
+    await updateById.call(client, "order-1", payload);
+
+    expect(put).toHaveBeenCalledWith("api/v2/order/order-1", payload, {
+      headers: { Authorization: "Bearer token-123" },
+    });
+  });
+});