🔌 tempra WebSocket Server

Server Status

Online

Environment: production

Started: 2025-10-27T12:27:23Z

WebSocket Endpoint

ws://localhost:8081/ws

Connect your WebSocket client to this endpoint

API Endpoints

Health Check:

/health

Get server health status and statistics

Connection Info

Protocol: WebSocket (RFC 6455)

Authentication: Required

Message Format: JSON

🔧 WebSocket Protocol

This server implements the tempra WebSocket protocol for real-time notifications.

Supported Message Types (Client → Server):

auth - Authenticate with user_id
ping - Connection health check
ack - Acknowledge notification receipt

Notification Types (Server → Client):

new_messages - New message notifications
delivery_status_update - Message delivery updates
zen_mode_update - Zen mode status changes
push_token_invalid - Push token validation alerts

📨 Acknowledgment System

All server notifications include a unique notification_id for tracking.

Features:

Client acknowledgment tracking
30-second timeout for unacknowledged notifications
Performance metrics and monitoring
Multi-device acknowledgment support

Example Server Notification:

{
  "type": "notification",
  "action": "new_messages",
  "timestamp": 1642247000,
  "notification_id": "notif_1642247000_1",
  "payload": {"message_count": 1}
}

Expected Client Acknowledgment:

{
  "type": "ack",
  "notification_id": "notif_1642247000_1"
}