DocsUpdated: February 202612 min read

Realtime Event Reference

Socket.io event contract for auth, presence, clip sync, file transfer, and private share.

Connection and Auth Events

  • Client -> authenticate, join_room, get_presence, ping
  • Server -> authenticated, joined, presence_update, pong
  • Error channel -> auth_error, connection_limit, subscription_required

Clipboard Events

  • Client -> send_clip
  • Server -> receive_clip, send_success, send_warning, send_error, rate_limited

File Transfer Events

  • Client -> file_init, file_chunk, file_ack, file_complete, file_error
  • Server -> receive_file_init, receive_file_chunk, receive_file_ack, receive_file_complete, receive_file_error
  • Rate control -> file_rate_limited

Private Share and Drop Events

  • Session control -> share_create, share_join, drop_upload, drop_join, share_cancel
  • Chunking -> share_metadata, share_chunk, share_ack, share_complete
  • Server -> receive_share_join, receive_share_metadata, receive_share_chunk, receive_share_ack, receive_share_complete, receive_share_cancel
  • Status -> share_sender_status, share_receiver_status, share_error, share_rate_limited

Tunnel Events

Pending tunnel requests are tracked per session and timed out if sender does not respond in time.

  • Server -> tunnel_request
  • Client -> tunnel_response