1 unstable release
0.1.0 | Oct 4, 2024 |
---|
#1737 in Network programming
178 downloads per month
475KB
13K
SLoC
Tunnel Server
Connection
sequenceDiagram
title Server Tunnel Connection Sequence Diagram
box Local Network
participant MoosicBox as Local MoosicBox Server<br>(moosicbox_server)
end
box Server
participant WS as Tunnel WS<br>(moosicbox_tunnel_server)
end
box rgb(143, 195, 255) PlanetScale
participant MySQL
end
MoosicBox ->> WS: Connect request (/ws?clientId=12345)
WS ->> MySQL: Upsert client_id and tunnel_ws_id in `connections` table
WS ->> MoosicBox: Connect success
loop every 5 minutes
MoosicBox ->> WS: [PING]
WS ->> MoosicBox: [PONG]
end
Data Stream Request
sequenceDiagram
title Server Tunnel Data Stream Request Sequence Diagram
box Internet
actor Client
end
box Server<br>(moosicbox_tunnel_server)
participant API as Tunnel API
participant WS as Tunnel WS
end
box Local Network
participant MoosicBox as Local MoosicBox Server<br>(moosicbox_server)
end
box rgb(143, 195, 255) PlanetScale
participant MySQL
end
Client ->> API: Request data<br>{clientId: "12345"}
API ->> WS: Request data<br>{clientId: "12345"}
WS ->> MySQL: Request tunnel_ws_id for clientId "12345"
activate MySQL#gray
MySQL ->> WS: Return tunnel_ws_id "127347374123"
deactivate MySQL#gray
WS ->> MoosicBox: Request data from ws connection "127347374123"
loop until all data sent
MoosicBox ->> MoosicBox: Read data (bytes)
activate MoosicBox#gray
deactivate MoosicBox#gray
MoosicBox ->> WS: Send packet of data (bytes)
activate WS#gray
deactivate WS#gray
WS ->> API: Send packet of data (bytes)
activate API#gray
deactivate API#gray
API ->> Client: Send packet of data (bytes)
activate Client#gray
deactivate Client#gray
end
Data Blocking Request
sequenceDiagram
title Server Tunnel Data Blocking Request Sequence Diagram
box Internet
actor Client
end
box Server<br>(moosicbox_tunnel_server)
participant API as Tunnel API
participant WS as Tunnel WS
end
box Local Network
participant MoosicBox as Local MoosicBox Server<br>(moosicbox_server)
end
box rgb(143, 195, 255) PlanetScale
participant MySQL
end
Client ->> API: Request data<br>{clientId: "12345"}
API ->> API: Create response buffer
activate API#gray
deactivate API#gray
API ->> WS: Request data<br>{clientId: "12345"}
WS ->> MySQL: Request tunnel_ws_id for clientId "12345"
activate MySQL#gray
MySQL ->> WS: Return tunnel_ws_id "127347374123"
deactivate MySQL#gray
WS ->> MoosicBox: Request data from ws connection "127347374123"
loop until all data saved to buffer
MoosicBox ->> MoosicBox: Read data (bytes)
activate MoosicBox#gray
deactivate MoosicBox#gray
MoosicBox ->> WS: Send packet of data (bytes)
activate WS#gray
deactivate WS#gray
WS ->> API: Send packet of data (bytes)
activate API#gray
deactivate API#gray
API ->> API: Push bytes to response buffer
activate API#gray
deactivate API#gray
end
API ->> Client: Send response buffer (bytes)
activate Client#gray
deactivate Client#gray
Dependencies
~25–45MB
~807K SLoC