Discovery

import { SurfClient } from '@surfjs/client'
 
// Discover a Surf-enabled site (fetches manifest automatically)
const client = await SurfClient.discover('https://shop.example.com')
 
// Or with options
const client = await SurfClient.discover('https://shop.example.com', {
  auth: 'sk-my-token',
  discoverTimeout: 5000,
})
 
// Inspect the manifest
console.log(client.manifest.name)      // 'My Store'
console.log(client.manifest.version)   // '1.0.0'
console.log(client.manifest.checksum)  // 'a1b2c3...'
 
// List all commands
const cmds = client.commands()
// => { search: { description: '...', params: {...} }, 'cart.add': {...} }
 
// Get a specific command
const cmd = client.command('search')
// => { description: '...', params: {...}, hints: {...} }
 
// Create from existing manifest (skip discovery)
const client2 = SurfClient.fromManifest(manifest, { baseUrl: 'https://...' })