feature/API-64/notify-order-update-only-by-socket

[andres15alvarez]

This pull request introduces a new WebSocket DTO (UpdateDeliveryWsDTO) and updates the OrderGateway to handle delivery updates via WebSocket. It also includes improvements to error handling, validation, and role-based access control for the new functionality.

New DTO and WebSocket Integration:

• src/order/dto/order-delivery.dto.ts: Added a new DTO class, UpdateDeliveryWsDTO, to handle delivery updates via WebSocket. It includes fields for the delivery ID, status, and optional employee ID, with appropriate validation and metadata decorators.
• src/order/order.gateway.ts: Imported the new UpdateDeliveryWsDTO to support the delivery update functionality.

Gateway Enhancements:

• src/order/order.gateway.ts: Added a new WebSocket event handler, updateDelivery, to update delivery information. This handler validates the incoming data, checks user permissions, and emits a deliveryUpdated event to notify relevant users about the update.

Validation and Error Handling:

• src/order/order.gateway.ts: Integrated ValidationPipe for structured validation of incoming WebSocket messages, with a custom exception factory to raise WsException on validation errors.

Role-Based Access Control:

• src/order/order.gateway.ts: Applied AuthGuardWs and RolesGuardWs to the updateDelivery method, restricting access to users with ADMIN or BRANCH_ADMIN roles.