WebSocket client for Sync receiver connections.

Uses WebSockex to connect from the receiver site to the sender's WebSocket endpoint. Sends requests and receives responses.

Architecture

The receiver uses this client to:

1. Connect to the sender's hosted channel
2. Send requests for data (tables, schema, records)
3. Receive responses and notify the caller (LiveView)

Usage

{:ok, pid} = WebSocketClient.start_link(
  url: "https://sender-site.com",
  code: "ABC12345",
  caller: self()
)

# Request available tables
WebSocketClient.request_tables(pid)
# Receive: {:sync_client, {:tables, tables}}

# Request records
WebSocketClient.request_records(pid, "users", offset: 0, limit: 100)
# Receive: {:sync_client, {:records, "users", result}}

Rate limiting

A sender that refuses a request with "error_code": "rate_limited" (the connection is over its requests per minute) gets the same request again after its "retry_after", clamped and within a total budget (PhoenixKitSync.RateLimit). Before each wait the caller receives {:sync_client, {:rate_limited, request_type, seconds}}; past the budget the request ends as {:request_error, request_type, :rate_limited}.