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
ws.on('order.updated', (data) => {
  console.log('Order updated:', data)
})
 
// Disconnect when done
client.disconnect()

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.manifest)
}