Client WebSocket

// Connect to WebSocket
const ws = await client.connect()
 
// Execute commands over WebSocket
const result = await ws.execute('search', { query: 'laptop' })
 
// Listen for events
const unsubscribe = ws.on('order.updated', (data) => {
  console.log('Order updated:', data)
})
 
// Check connection state
console.log(ws.state) // 'connected' | 'connecting' | 'disconnected' | 'reconnecting'
 
// Disconnect when done
client.disconnect()

import { WebSocketTransport } from '@surfjs/client'
 
const ws = new WebSocketTransport({
  reconnect: true,              // Auto-reconnect on disconnect (default: true)
  maxReconnectAttempts: Infinity, // Max reconnect attempts (default: Infinity)
  reconnectDelay: 1000,         // Initial delay in ms (default: 1000)
  maxReconnectDelay: 16000,     // Max delay in ms (default: 16000)
  pingInterval: 30000,          // Keepalive ping interval in ms (default: 30000)
  onDisconnect: () => console.log('Lost connection'),
  onReconnect: () => console.log('Reconnected!'),
  onStateChange: (state) => console.log('State:', state),
})
 
await ws.connect('wss://shop.example.com/surf/ws', 'sk-token')

const client = await SurfClient.discover(url, {
  // Retry configuration
  retry: {
    maxAttempts: 3,
    backoffMs: 500,
    backoffMultiplier: 2,
    retryOn: [429, 502, 503, 504],
  },
 
  // Response caching (skips commands with sideEffects: true)
  cache: {
    ttlMs: 60_000,   // 60s TTL
    maxSize: 100,     // Max 100 cached entries
  },
})
 
// Execute — automatically retries and caches
const result = await client.execute('search', { query: 'laptop' })
 
// Clear cache for a specific command
client.clearCache('search')
 
// Clear all caches
client.clearCache()
 
// Check for manifest updates (checksum comparison)
const update = await client.checkForUpdates()
if (update.changed) {
  console.log('Manifest updated:', update.checksum)
  console.log('New manifest:', update.manifest)
}