The SDK provides a structured error hierarchy:
Code
ViucraftError
├── ViucraftValidationError — client-side validation failures
├── ViucraftRateLimitError — HTTP 429 responses
└── ViucraftNetworkError — connection failures and timeouts
Retry Configuration
The SDK automatically retries HTTP 429 responses with exponential backoff.
| Option | Default | Description |
|---|---|---|
maxRetries | 3 | Maximum retry attempts |
initialDelayMs | 1000 | Initial delay (ms) |
maxDelayMs | 30000 | Maximum delay (ms) |
backoffMultiplier | 2 | Backoff multiplier |
Disable retries with retry: false.