core/services/socket/ — Socket.IO Service

What problem does it solve?

This Skill centralizes management of a single Socket.IO WebSocket connection for the Flutter client, preventing duplicated connections and simplifying real-time order tracking and event handling across the app.

Core Features & Use Cases

• Singleton lifecycle management: maintain one global socket, connect on login and disconnect on logout.
• Authenticated handshake & reconnection: perform JWT-authenticated handshake with Authorization headers and automatic reconnection with configured attempts and delay.
• Room management & typed event streams: join and leave per-order rooms, emit events, and expose broadcast streams with typed parsers plus a convenience Map parser.
• Use Case: A TrackingBloc joins an order room, subscribes to driverLocation and orderStatusChange streams filtered by orderId, and updates UI state in real time.

Quick Start

Use the socket service to connect with the user's JWT, join the room for a given orderId and orderType, and subscribe to driverLocation and orderStatusChange events filtered for that order.